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Preface 


This is the second of two books on the T/S 2068 computer. The first 
book, Timex Sinclair 2068 Beginner/Intermediate Guide, is a guide to 
getting started with the T/S 2068 computer. It deals with setting up and 
operating the computer, and learning to program in BASIC. This 
second book will take you beyond BASIC — into the world of computer 
circuits, the Z80 microprocessor, the BASIC interpreter, and machine 
language programming. The main goal is to show you how to make 
your programs run faster and do things that are otherwise impossible 
with BASIC. At the same time, you will learn a lot more about how your 

computer works. 

This book will assume only a working knowledge of the T/S 2068 
and BASIC programming. That is, you should know how to turn on the 
computer and be able to enter and run simple BASIC programs. You 
do not need to know anything about bits and bytes or RAM and ROM 
— it begins with a simple explanation of what a computer is and how it 
works. If you are new to computers, or are not familiar with BASIC 
programming, then you may wish to start with the Timex Sinclair 2068 
Beginner/intermediate Guide. 

This book serves two purposes. It describes how a computer works, 
and it introduces the reader to machine language programming. The 
first part of the book covers computer basics: the operation of comput- 
ers in general, and the T/S 2068 in particular. It includes a description 
of most of the T/S 2068 hardware. The second part introduces 
machine language — the native tongue of the Z80 microprocessor 
that drives the T/S 2068. Part Two ends with a section that describes 
how machine language routines can be used from within BASIC 
programs. 

This book also serves as a reference guide for the T/S 2068 com- 


puter. It contains complete information on the various expansion con- 
nectors for the hardware buff trying to interface a new device to the 
computer. The machine language programmer will find a wealth of 
technical information on the Z80 Central Processing Unit and the 
AY-3-8912 Programmable Sound Generator used in the T/S 2068. 
This book describes in detail each instruction in the Z80’s repertoire. In 
addition to the hardware descriptions, the book also discusses the 
inner workings of the BASIC interpreter, the special memory mapping 
scheme used by the T/S 2068, and the Function Dispatcher routines 
which make up the heart of the computer's operating system. Indeed, 
there is something for everyone. 

Hopefully this book will widen your horizons and unravel a few of the 
mysteries that surround computers. When you've finished reading it, 
you will want to keep it near your computer so the reference material is 
readily available. 


JEFFREY Mazur 
| gratefully acknowledge all of the help and support | received from 


my wife Lynne, and from my children, Michael, Jonathan, and 
Jessica, who put up with “daddy's book.” 


Contents 


PART 1—How Computers Work 


Section A—Computer Basics. 


Introduction — The Computer as a Machine — The Four Basic Computer 
Parts — Bits of Information — Boolean Logic 


CHAPTER 2 


THe BinanY NUMBER SYSTEM....... 6... cece eee eee eee 25 
Introduction — Converting Binary Numbers to Decimal — Converting 
Decimal Numbers to Binary — Binary Mathematics —- The Hexadecimal 
Number System — Other Binary Representations 


CHAPTER 3 


Exp.orine THE T/S 2068 BASIC..............0. eee eee eens 48 
T/S 2068 Operating System — A Tutorial on the T/S 2068 BASIC 
Interpreter — Variable Storage — How the BASIC Interpreter Operates —. 
Program Storage 


Section B—Inside the T/S 2068 


CHAPTER 4 


THE: 280: CPU coe screws nance its or seme tell cad Asche ieee ate 77 
Introduction — Registers — The Flag Register — CPU Operation — 
Special Functions — Addressing Modes 


CHAPTER 5 


Memory Map OF THE T/S 2068 ......... 0. cece cece eee eee ceas 91 
Bank Selection — Bank Switching Hardware/Software ~— Home Bank 
Memory Map — Input/Output Facilities — Keyboard — Sound — Joysticks 


CHAPTER 6 
CONNECTING TO THE OuTSIDE WORLD .......-... cece ceeeeees 103 
Joystick Connectors — DOCK Connector — Peripheral Expansion 
Connector 
CHAPTER 7 
UsING THE T/S 2068’s PROGRAMMABLE SOUND GENERATOR...... 113 


Inside the PSG — Audio Basics — Programming the PSG — Combining 
the Output Channels — Other Effects 


CHAPTER 8 


THE VIDEO DISPLAY ..... 0c cece eect ccc c ence eee eeeeeeeees 131 
Introduction — Video Basics — Display Modes — RGB Video 


PART 2—Machine Language 


Section A—Programming the Z80 


CHAPTER 9 


INTRODUCTION TO MACHINE LANGUAGE PROGRAMMING .......... 145 
BASIC vs. Machine Language — Hand-Coding vs. an Assembler — 
Understanding the Z80 Documentation — The USR Command — The Z80 
Instruction Set 


CHAPTER 10 


MovING INFORMATION: THE LOAD INSTRUCTION 
Register Addressing — Immediate Addressing — Register Indirect 
Addressing — Indexed Addressing —- Extended Addressing — Implied 
Addressing — 16-Bit Load Group : 


CHAPTER 11 
PROGRAM Flow: JUMP, CALL, ano RETURN 


Relative Addressing — Register Indirect Jumps — Automatic Looping — 
CALL and RETURN Group — Restart Group ° 


CHAPTER 12 


ARITHMETIC AND Loaic OPERATIONS 
Z80 Instructions — Signed Arithmetic — 16-Bit Arithmetic Group — Bit 
Operations — ROTATE and SHIFT Group — Multiplication and Division 


CHAPTER 13 


SPECIAL INSTRUCTIONS AND I/O 
Exchange Group: EX and EXX — Block Transfer Group: LDI, LDIR, LDD, 
LDDR — Block Search Group: CPi, CPIR, CPD, CPDR — Input and 
Output Group: IN, OUT — Block I/O: INI, INIR, IND, INDR, OUTI, OTIR, 
OUTD, OTDR — General-Purpose Arithmetic Group: DAA, CPL, NEG, 


CCF, SCF — Miscellaneous CPU Control: NOP, HALT, DI, El, IMO, IM1, 
IM2 


Section B—Machine Language on the T/S 2068 


CHAPTER 14 


Usina Macuine LanGuaGe From BASIC................0005- 
Creating a Machine Language Program — Choosing the Right Location — 


Assembling the Program — Cassette Storage of Machine Language 
Routines 


CHAPTER 15 


USING THE BUILT-IN ROM RouTiNES............0.c0c0sceeeeee 
Precious POKES — Using USR — The Function Dispatcher 


i 


APPENDIX A 


POWERS [OR 2:2 wistcerc el gcte vein Ses dieelds dares taone ease eA Geass 224 
APPENDIX B : 

Hex TO DECIMAL CONVERSION ..... 0.0 ccc ccc e eee ee eee eeees 225 
APPENDIX C 

ASCII CHARACTER SET 2.0... ccc cece eect eee eee en ences 227 


PART 1 
HOW 
COMPUTERS 
WORK 


SECTION A 
COMPUTER BASICS 


l | 
What Is a Computer? 


INTRODUCTION 


In the world of computers, the T/S 2068 stacks up as a relatively 
small, slow, and limited machine. It is considered a personal computer 
because it is used by only one person at a time, as opposed to larger 
computers that can handle many users simultaneously. The latter are 
referred to as mainframe computers or minicomputers depending on 
their size. Personal computers such as the T/S 2068 are also called 
microcomputers—primarily because they are built around a special 
electronic part or “chip” called a microprocessor. The T/S 2068 uses 
the Z80, one of the most popular microprocessors ever developed. 
Much of this book is devoted to describing how this tiny chip of silicon 
works. 

Despite the many differences between a T/S 2068 and an IBM 370 
mainframe computer, they both share a common design philosophy. In 
fact, it would be safe to say that almost all present-day computers fit 
the description of a stored-program, digital, electronic, data proc- 
essing machine. This rather lengthy description also sums up the 
history of computing machines. 


THE COMPUTER AS A MACHINE 


Above all, the computer is a machine: it allows us to perform some 
function easier or faster than we can manually. It also allows us to 
accomplish some tasks that are otherwise impossible. As an example, 
consider another machine that you may be more familiar with — the 
lever. Long ago it was learned that a lever could be used to move 
objects that were too heavy to move by hand. The lever accomplishes 
this task by transforming a small force applied over a large distance 
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into a larger force applied over a smail distance. While levers help 
accomplish physical work, computers aid in the performance of men- 
tal work, otherwise known as information processing or data 
processing. : 


Mechanical vs. Electronic Machines 


A lever is classified as a mechanical machine since it requires 
movement to perform its task. The first “mental machines” were also 
mechanical in nature. One of the first was the abacus, a mechanical 
machine that aids in the performance of a mental process: calculating 
numbers. Subsequenily, other mechanical calculators were devel- 
oped, including slide rules and adding machines. 

Today, however, most of our mental machines, including the modern 
computer, are electronic machines. They use stationary electronic 
devices instead of moving mechanical parts. It is the control of cur- 
rents that is important in electronics. Therefore, the electronic analogy 
of the lever is called an amplifier. It is a device that takes a small 
electric current (or signal) and uses it to control a larger one. 

Depending upon the arrangement of other components in an elec- 
tronic circuit, amplifiers can accomplish tasks such as inverting, 
adding, performing logarithms, or storing electronic signals. There- 
fore, almost every electronic circuit is based upon the use of ampli- 
fiers. Consequently, much of the relatively brief history of electronics 
has involved finding the best electronic amplifying device. The original 
amplifiers were vacuum tubes. Today they have been replaced by solid 
state transistors. 


Analog vs. Digital Computers 


Early in their history, computers dealt with data as voltage signals in 
a one-to-one relationship. If a signal level of 2 volts represented 200 
miles per hour (mph), for example, then 1 volt represented 100 mph, 
and 0.52 volts was 52 mph, etc. Information treated this way is referred 
to as analog, thus early computers were called analog computers. 

When analog computers had their day (it was a relatively short one), 
they performed calculations in seconds that would have taken many 
hours to perform by hand, even with a slide rule. But such computers 
were limited to dealing with numbers—for example, calculating the 
trajectory of a rocket. Itwas soon discovered, however, that almost any 
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type of information could be processed if it was in digital form, thatis, in 
a series of discrete chunks. This was a major breakthrough in the 
design of computers. 

To appreciate the difference between analog and digital forms of 
information, consider these ‘few examples. Analog information can 
have an infinite number of values: distance, time, and temperature, are 
all examples. We can have a stick that is 4 feet long, 4.527 feet long, or 
any possible value in between. Digital information, however, is 
restricted to discrete values: the flip of a coin is either heads or tails, 
the change in our pocket consists of a finite set of coins, and we can 
only have whole numbers of children (census figures notwithstanding, 
no family can have 2.3 children). 

In a digital computer, all information to be processed (whether it 
represents numbers, text, or electronic signals) is first converted to a 
series of signals represented by binary ones and zeros. Dealing with 
only digital signals, the electronics are much simpler. When using 
amplifiers, for example, you need not worry about nonlinearities or 
distortion, since they operate either fully on or fully off. In this sense, 
the amplifier (tube or transistor) becomes an electronic switch. This 
gives rise to some specialized circuits called gates. The name is aptly 
chosen since electric current moves through these circuits only when 
the “gate” is open. We'll discuss gates in detail a little later. The point 
here is that gates, which form the basis of digital processing, are very 
easy to make. Today, in fact, thousands of gates can be squeezed onto 
a piece of silicon no larger than a pencil eraser. The development of 
the modern computer, then, was from the mechanical to the electronic, 
and from the analog to the digital. 


Stored Program Architecture 


While digital electronics gave a great boost to computer design, a 
major stumbling block still remained. The early computers were pro- 
grammed by connecting wires to various circuit elements. Making a 
simple change in the program often involved a complicated and time- 
consuming process. This cumbersome technique also limited the 
program size. The idea of storing the program itself within the 
machine’s memory was the final link leading to today’s computers. By 
replacing the wires with a bit pattern in memory, programs were made 
more flexible and were limited in size only by the amount of memory 
available. This practice, known as the stored-program technique, was 
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a milestone in computer science—only today have we begun to reach 
its greatest potential. 

Stored-program machines operate by executing instruction cycles. 
Each cycle begins by having the computer fetch an instruction from 
memory. This information is then decoded by the computer to direct its 
further action. In most cases, the computer will read one or two more 
pieces of information to finish its cycle. All of this takes place extremely 
fast—in the T/S 2068, up to one million instructions can be executed in 
one second! 


THE FOUR BASIC COMPUTER PARTS 


Any computer can be divided into four main parts: the input section, 
the Central Processing Unit, the memory, and the output section. Fig. 
1-1 shows how these sections are connected. The arrows indicate 


which direction information can flow. 


CENTRAL 
PROCESSING 


MEMORY 


Fig. 1-1. The four basic parts of a computer. 


Input 


The input section is the connection to the outside world through 
which information is fed into the computer. In the case of the T/S 2068, 
there are three input devices supported by the standard machine. 
They are the keyboard, the joystick, and the cassette playback. Each 
of these devices allows the user to put information into the computer. 
Any connection between different parts of a computer, or between the 
computer and the human user, is called an interface. The keyboard, of 
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course, is the main interface used for communicating with the com- 
puter and telling it what to do. 


The CPU 


The CPU, or Central Processing Unit, of the T/S 2068 is the Z80 
microprocessor (described in detail in Chapter 4). The Z80 is only one 
of many microprocessors. For example, another popular one is the 
6502 used in Apple, Atari, and Commodore computers. Each micro- 
processor has its own architecture and instruction set. These deter- 
mine the machine language with which the CPU is programmed. 


Memory 


The CPU can only handle a small packet of information at one time. 
in the T/S 2068, the Z80 processes eight tiny pieces of information, 
called bits, in each packet. These packets, in turn, are called bytes. 
We'll have a lot more to say about bits and bytes later, but in general, 
you can consider each byte as representing a single character (letter, 
number, punctuation mark, etc.). 

Since we usually want to process more than one byte of informa- 
tion—(the test scores of a class might be hundreds of bytes; a busi- 
ness letter, thousands)—we need some place to store this 
information, also called data, where the CPU can easily reach it. We 
also need storage for the information that tells the computer what to 
do, its program. Both data and program can be stored in a portion of 
the computer called memory. The computer's memory is divided into 
two major classifications called RAM and ROM. 

RAM—There are many types of memory devices that can store 
information in a computer. Most of the devices accept data-from the 
computer—they are “written to.” They then hold the data indefinitely 
and feed it back when asked—they are “read out.” This type of 
memory is referred to as Random Access Memory, or RAM for short. 
The T/S 2068 has 49,152 bytes or 48K internal RAM.” 


ROM—Another type of memory device used in the T/S 2068 is 
called Read Only Memory, or ROM. This device is “written to” at the 


*The “K” stands for kilobytes or a thousand bytes, from the metric prefix “kilo” meaning 
thousand. However, in the computer's binary number system, the closest “round” 
number to one thousand is actually 1024. Thus each “K” actually stands for 1024 bytes. 
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factory and can only be read by the computer. ROM is used to hold 
information that is essential to the operation of the computer, but which 
will not require any changes. The operating system and BASIC inter- 
preter of the T/S 2068 are examples of information that is stored in 
ROM. An advantage of storing information in ROM is that the data is 
permanently available, even after the computer has been turned off 
and on again. In contrast, ail information stored in RAM is lost when- 
ever the power is removed. 

Because of the preceding distinction, ROM is often referred to as 
nonvolatile storage and the type of RAM used in the T/S 2068 is 
considered volatile storage. The T/S 2068 contains 24K of internal 
ROM. Additional ROM and/or RAM can be added to the T/S 2068 
through the front panel DOCK connector or through the expansion 

- connector on the rear of the computer. See Chapter 5 for a complete 
description of the T/S 2068’s memory capabilities. 


Output 


All of the preceding discussion would be meaningless if there was 
no way to get the information back out of the computer in some useful 
form. The T/S 2068 has two output devices. By far the most useful is 
the video display. This is the picture that you see on the television set 
or monitor. Whether you use the TV or the MONITOR jack on the 
computer, what you see is a display that is generated by the. computer. 
The sole purpose for this display is to present information from the 
computer in a manner recognizable by humans. The second form of 
output from the computer is through the built-in speaker underneath 
the T/S 2068. This device allows the computer to signal aurally, 
generating anything from a simple beep for attention, to a fully orches- 
trated tune. If you have a printer such as the Timex 2040 connected to 
the computer, then you have a third form of output—one on which the 
computer can generate a more permanent record called “hard copy.” 


BITS OF INFORMATION 


Being a digital electronic device, a computer can only deal with 
information as one of two forms: either the presence of a voltage (or 
current) or its absence. At any point in time, a single wire inside the 
computer can only be in one of two states. It can be connected to a 
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source of electricity placing it at a high potential or it can be at a low 
- potential otherwise known as ground. These two states are also 
referred to as +5 and ground, one and zero, or hi and low. Any point in 
a digital electronic circuit will be in one of these two states. When a 
single wire carries information from one point to another in this 
scheme, it carries the smallest amount of information imaginable—a 
bit. 

Fig. 1-2 shows how a wire can transmit the status of an electric 
switch to a receiving indicator. There is a battery to supply the elec- 
tricity, a switch to control the flow, and a light to indicate when the 
circuit is complete and current is flowing. In Fig. 1-2A the light is dark 
because the switch is open, or turned off. In Fig. 1-2B the switch has 
been moved to the on position completing the electrical circuit. Now 
the lamp glows because of the electrical current flowing through it. 
(Note that we have taken the liberty of defining an electrical ground to 
act as the return path for the current.) 

A circuit such as that in Fig. 1-2, can transmit only one piece of 
information: either the light is on or it is off. Nonetheless, circuits 
similar to this are used in a variety of signaling applications—a hospital 
room call button, for example. By activating a switch that turns on a 
light at the nurse’s station, you communicate the information that you 
need assistance. 

Fig. 1-3 shows how the light switch can be expanded. By adding 
one more wire and switch, as shown in Fig. 1—3A, itis possible to signal 
the four different conditions shown in Fig. 1-3B. Similarly, with three 
wires eight distinct patterns can be transmitted. Since each new light 


SWITCH 
a CLOSED 
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sty 


/ 
BATTERY - 
ELECTRICAL___ | Ps 
is GROUND : + + 
A. Signal off. B. Signal on. 


Fig. 1-2. A circuit that transmits one “bit” of information. 
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Fig. 1-3. Transmitting multiple bits of information. 


added can be in one of two different states, it doubles the number of 
possible patterns. In general then, with “n” number of wires we can 
transmit two to the “n’th power different states. This is the basis of a 
binary system—the number system we will cover in detail in the next 
chapter. 


BOOLEAN LOGIC 


Before abandoning the light switch circuits, we’ll use them to explain 
the basic logic operations performed by computers. In Fig. 1-2, we 
can represent pushing the switch as a logical 1 and likewise for having 
the lamp lit. Therefore not pushing the switch and the lamp being off 
are assigned the value 0. The function performed by Fig. 1-2 can then 
be represented by listing all of the possible switch conditions and their 
effect on the lamp. In this simple case, the information can be pre- 
sented as shown in the state table of Fig. 1—4A. This type circuit is 
sometimes called a buffer and its logic symbol is shown in Fig. 1-4B. 
The state table is sometimes called a transition table and is similar to a 

truth table. Each is used to follow circuit logic. 
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SWITCH LIGHT 


BUFFER 


les INPUT “ OUTPUT 
1 

A. Truth table. B. Logic symbol. 

. Fig. 1-4. A buffer. 


_If the switch is changed slightly so that it is normally closed and then 
opens when pressed, the circuit then looks like Fig. 1-5. Keeping the 
same nomenclature, namely that pressing the switch is considered a 
logic 1, we then have a circuit known as an inverter. The truth table and 


SWITCH 
NORMALLY 
CLOSED 
' LIGHT if # 


\ 


Fig. 1-5. A circuit with a different type of switch — an inverter circuit. 


logic symbol for the inverter are shown in Fig. 1—6. Note the addition of 

a small circle to the logic symbol which indicates that the logic state 

gets reversed, or inverted, when passing through this device. Such a 
SWITCH LIGHT : 


INVERTER 
° Pe) 
Lee INPUT | > OUTPUT 
1 


A. Truth table. B. Logic symbol. 
Fig. 1-6. An inverter. 
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gate performs the logical not function—that is, it puts out the opposite 
value from what is fed in. 

The two types of logic elements discussed so far only have a single 
input and output. More useful functions can be derived using more 
than one input. In our analogy, this means adding more switches but 
keeping only one light. For example, another switch can be connected 
as shown in Fig. 1-7. In electronics lingo these switches are said to be 


a = } 
SWITCH A 


= = } 
SWITCH B 


Fig. 1-7. A circuit with two switches in parallel — an on circuit. 


in parallel. The result of wiring two switches in this manner is to allow 
pressing either switch to cause the lamp to light. It does not matter 
whether switch A or switch B is pressed. (The lamp will also light if both 
are pressed.) Since either one switch or the other can light the lamp, 
this circuit performs the logical or function and therefore is called an 
or gate. The truth table and symbol are shown in Fig. 1-8. To read this 


SWITCH B 
0 1 
0 OR GATE 
SWITCH A INPUT A 
OUTPUT 
1 INPUT B 
A. Truth table. B. Logic symbol. 


Fig. 1-8. An on gate. 


table, locate the row that corresponds io the states of switch A. Then 
find the column that corresponds to the state of switch B. At the 
intersection of this row and column there is a logic value which 
represents the output of the gate. 
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Another way of adding a second switch is shown in Fig. 1-9. This 
places the two switches in series and, therefore, requires that both 
switches be pressed in for the lamp to light. In this case, the circuit - 


o———————0 0 
SWITCH A SWITCH B 


Fig. 1-9. A circuit with two switches in series — an ano circuit. 


performs the logical AND function, since both input A and input B must 
be in the logic 1 state for the output to be a 1. The truth table. and logic 
symbol for the anp gate are shown in Fig. 1-10. 

SWITCH B 


0 1 
AND GATE 
0 
SWITCH A INPUT A 
OUTPUT 
1 1 
INPUT B 


A. Truth table. B. Logic symbol. 
Fig. 1-10. An. anp gate. 


Note that itis also possible to have more than two inputs for one gate 
as shown in Fig: 1—11. In:this case, all:four inputs must “go high” for the 
output to be high. Often itis convenient to add an inverter to the on and 
AND gates creating the nor and NAND gates as shown in Fig. 1-12. 


4-INPUT AND GATE 


A 
8 

INPUT c OUTPUT 
D 


Fig. 1-11. A four-input AND gate. | 


24 Timex/Sinclair 2068 Intermediate/Advanced Guide 
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SYMBOL 
NOR gate. B. NAND gate. 
Fig. 1-12. Truth tables and logic symbols for or and anp gates with 
inverters. 


The three logic elements — AND, or, and not — are the building 
blocks of all digital circuits. It can be proven that all other logical 
operations can be built from these three simple blocks. For example, 
an Exclusive or (or xor) device must produce a high output when 
either one of its inputs, but not both, goes high. 

The three logic elements — aANnbD, oR, and not — are the building 
blocks of all digital circuits. It can be proven that all other logical 
operations can be built from these three simple blocks. For example, 
an Exclusive or (or xor) device must produce a high output when 
either one of its inputs, but not both, goes high. The truth table and 
symbol for this device are shown in Fig. 1-13 along with a diagram 
showing how this circuit can be derived from the primitive gates. 


XOR GATE 


=o 


A. Truth table. B. Logic symbol. 


OUT 


C. xor gate using or, AND, and NAND gates. 
Fig. 1-13. The Exclusive or (xor) gate. 


2 
The Binary Number 
System 


INTRODUCTION 


Since most computers (including the T/S 2068) work with two-state 
electronic circuits, any information to be processed must first be 
converted into a series of binary numbers. Therefore it is important to 
understand fully the base two-number.system. As shown in the pre- 
ceding chapter, the brains of the T/S 2068 reside in the Central 
Processing Unit (CPU). All of the operations performed by the CPU are 
based upon the binary system. 

The purpose of any number system is to convey information about 
quantity, just as languages are used to convey thoughts and ideas. 
Although many different languages exist, there is no one “correct” 
language. When you say “hello” to someone, you expect him to 
understand it as a greeting. When visiting France, however, your 
greeting might be met with strange looks unless you said “bonjour.” 

In view of the diverse languages in existence today, it is quite 
remarkable that one number system is used almost universally. This is 
the base 10 (decimal) number system that most people start learning 
before they can even read. This is not the only possible system, and 
certainly not the most convenient in many cases. Another number 
system you may be familiar with is the Roman Numeral system. This 
system undoubtedly lost its appeal because it does not have a precise 
mathematical foundation. (Have you ever tried to multiply XVII times 
IV?) Since mathematics is so closely tied with numbers, a concise and 
logical numbering system is essential. 

Probably because we have ten fingers (which are easy to count on), 
our number system is based upon the number 10. We learn to count, 
and thus express quantity, using 10 digits. These digits are written 
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using the numerals 0, 1, 2, 3, 4, 5, 6, 7, 8, and 9. When expressing 
numbers greater than nine, we need to add another digit, or place, to 
the left of the first number. Thus after 9 we write 10 which means one 
group of ten plus zero more. Then comes 11 (one group of ten plus one 
more), 12,13. . ., etc. This continues up to 99 (nine groups of ten plus 
nine more) after which we add another digit. The number 349 really 
means three hundred plus forty plus nine, as shown in Fig. 2-1. 

Notice that when numbers are written this way, the first digit (the one 
on the left) carries the most importance or significance. The digit on 
the right is the least significant. That is, if the 9 became an 8, there 
would only be one less; if the 3 were changed to a 2, however, it would - 
mean a loss of one hundred — certainly more significant. It should 
also be noted that the value of each place in our numbering system is- 
simply a power of 10. Thatis, the last number represents how many ten 
to the zero power” or ones there are in the number. The next number. 
represents how many ten to the one power, or tens, there are. Then 
comes the ten to the two power (10 x 10), or hundreds, etc. This 
process is continued until there are enough places to express. any 
number desired. 

With this understanding; it is then very easy to describe other 
number systems. Using the same procedure, we can simply change 


102 OR 100 POSITION 
101 OR 10 POSITION 


10° OR 1 POSITION 


a 
> 


-— 


4x10 = 40 


3x 100 = 300 
349 


Fig. 2-1. Decimal notation 


*Any number raised to the zero power equals one. 
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the base number, also known as the radix, from 10 to any other value 
and come up with a new numbering system. In particular, since 
computers only have two states with which to count (i.e., two fingers), it 
would seem more natural for computers to use a base 2 number 
system. This is commonly known as the binary number system. With 
only two numerals, a single digit number can only count from 0 to 1. 

Using the standard number system format just described, it is 
possible to write numbers of any given size. First we must determine 
the value or weight of each numeral in a binary number. Since humans 
find it easier to think in terms of decimal numbers, it is helpful to 
represent each binary column as its decimal weight. Thus, the binary 
number 11100101 is interpreted as shown in Fig. 2-2. For larger 


27 OR 128 POSITION 


28 OR 64 POSITION 


25 OR 32 POSITION 
24 OR 16 POSITION 


23 OR 8 POSITION 


22 OR 4 POSITION 


21 OR 2 POSITION 


i 2° OR 1 POSITION 
1 


— = 1 

Ox2 = 0 

1x4 = 4 

0x8 = 0 

Ox16 = 0 

1x32 = 32 

1x64 = 64 

1x 128= 128 


229 


Fig. 2-2. Binary notation. 
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Table 2-1. Negative and Positive Power of Two 


1 

0.5 

0.25 

0.125 

0.0625 

0.03125 

0.015625 

0.0078125 

0.00390625 

0.001953125 

0.0009765625 

0.00048828125 

0.0002441 40625 

0.0001220703125 

0.00006103515625 

0.000030517578125 

0.0000152587890625 

0.00000762939453125 

0.000003814697265625 

0.0000019073486328125 
0.00000095367431640625 1048576 


numbers, higher powers of two can be taken from Table 2—1. Note that 
whenever there is doubt as to the base of a given number, a small 
subscript will be placed after the number to indicate the radix used. 


CONVERTING BINARY NUMBERS TO DECIMAL 


Having defined a precise format for all number systems, including 
base 10 (decimal) and base 2 (binary), it should not be difficult to 
convert a number from one base to another. For example, we have just 
shown that converting a binary number to decimal involves nothing 
more than writing down the powers of two that correspond to each “1” 
digit in the binary number and then adding them all up. This is quite 
simple, but if you have a lot of numbers to convert, it can get quite 
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tedious (especially when dealing with memory addresses that are 16 
binary digits long). Fortunately, we have a computer — and computers 
are wonderful for doing tedious things. Therefore, we will write a 
program for the T/S 2068 that will convert binary numbers to their 
decimal equivalents. : 

A binary number must be input to start the program, and it proves 
easier to decipher this number if itis treated as a string. This preserves 
any leading zeros (which would be lost if we treated it as a numeric 
input). This also allows each digit to be examined using the string 
“slicing” capabilities of the T/S BASIC. The next step involves looking 
at each digit entered and keeping a running total of all binary places 
that contain a 1. For each 1 found, the value of 2 raised to the 
appropriate power is added to the total. Raising to a power is accom- 
plished in this program using the exponentiation function denoted by 
the ~ symbol. 

Listing 2-1 shows the simple binary to decimal conversion program. 
It starts by initializing a running total variable, a, in line 10. Line 20 
accepts the desired binary number to be converted and assigns it to 
the string variable a$. Line 30 gets the number of digits entered which 
we will need later and line 40 checks to see if we are done (by entering 
no number). Line 50 sets up a loop to look at each character in the 
string and along with line 60 determines if that digit is zero. Note the 
formula (i — i) in the slicer which causes the search to proceed from 
right to left instead of left to right as normal. Also note the comparison 
to the string constant 0 instead of the number; this is due to the use of a 
string variable for the input number. 

If the current digit is not a zero, then line 70 executes, adding the 
designated power of two to the total. Otherwise, the program skips to 
line 100 where the next digit is inspected. After all of the digits have 
been checked, the program finishes by printing out both the binary 
and decimal formats for the number. 

Listing 2—1 
16 LETa=¢ 
26 INPUT a$ 
38 LETI=LENa$ 
46 IF l=@ THEN STOP 
56 FORi=gTOI-1 
69 IF a$(l-i)="” THEN GO TO 169 
76 LETa=at2ti 
10 = NEXTi 


158 PRINT a$,a 
266 GOTO 
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CONVERTING DECIMAL NUMBERS TO BINARY 


Converting decimal numbers to binary is only slightly more compli- 
cated. Whereas the previous conversion proceeded from right to left 
and involved addition, we now use the reverse of this technique. 
Therefore, the first step is to find the largest power of two that is still 
smaller than the given number. Actually, we could start with any large 
power of two, but that would only give us many “leading zeros’ in front 
of the answer and these are usually meaningless. Having found the 
proper factor as described above, we can then write down a 1 as the 
first digit of the answer. Next, subtract this amount from the original 
number leaving some positive remainder. (This remainder must be 
less than the previous factor or we did not start with the correct power 
of two.) We then continue with each of the smaller binary factors. If the 
remainder is less than the current factor, write down a 0 for that digit. 
Otherwise write down a 1 and subtract that factor from the remaining 
value. This process continues until the last binary digit, or bit, is 
reached. For example, Fig. 2-3 shows how the decimal number 45 
would be converted into binary. Of course, after the conversion is 
done, we can add any number of leading zeros to normalize the result 
for eight or sixteen places. 


45 1 0 1 1 0 1 
=32x 1 ——___ 

13 
-—16x0 

13 

-8x1 

5 

-4x1 

-—2x0 

-1x1 

0 

45149 = 1011015 


Fig. 2~3. Converting a decimal number to binary by subtraction. 


Once again, we can leave the tedium to our computer. Although the 
conversion from-decimal to binary seems more difficult for us, notice 
that the program in Listing 2—2 is actually more compact. 
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: Listing 2-2 
1@ INPUT a: PRINT a, 
26 FORi=15TO@STEP-1 
38 IFa<2ti THEN GO TO 79 
46 PRINT "1"; : 
56 LET a=a-2ti 
646 GOTO8¢ 
76 PRINT "Q”; 
80 NEXTi 
9% GOTOM 


BINARY MATHEMATICS 


Having covered the complete foundation for the binary number 
system, we shall now investigate the subject of binary arithmetic. In 
many ways, binary calculations are easier to perform due to the limited 
size for each digit. 


Addition 


Probably the easiest. way to describe binary addition is by sum- 
marizing the results of all possible two-number addition problems: 


=--=0 


= 0 plus carry 


++44+ 
-O-0 


You may see a similarity between these results and the discussion 
of the Exclusive-or function from the last chapter. You should begin to 
see now how a bunch of wires and switches can actually perform 
something useful like adding numbers. With this set of rules, it is 
possible to add any two.binary numbers of arbitrary length. Simply 
start at the right column and add each pair of numbers just as we add 
decimal numbers. Likewise, whenever there is a carry into the next 
digit it gets added with the other digits in that column. Of course, now 
there are three numbers to add; but this proves to be no more difficult. 
If one of the numbers is zero, then the result can be found by adding 
the other two numbers. When adding three 1’s, the answer is simply 1 
plus a carry into the next place. A few examples should make this 
clearer: 
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| PEL PEErtdd 4 carries 
1199191 98101191 11911119 
+ 98181190 + 11988111 + 91119119 
11119110 11118190 191919198 
Subtraction 


if we were to extend this line of thinking, we would next need a set of 
rules to define subtraction. Instead of having a “carry” bit to worry 
about, we would now have to deal with the possibility of a “borrow” 
condition. For example, when subtracting 297 from 481, the problem 
is written like this: 


481 @ minuend 
— 297 4 subtrahend 


184 @ remainder 


We start by trying to subtract 7 from 1. Since that would leave us with a 
negative number, we borrow ten from next column, instead, changing 
the 8 to a 7. Then we subtract the first 7 from 10 + 1, or 11, resulting in 
the answer of 4. We then repeat this process until all columns have 
been subtracted. Hopefully, we do not run out of columns to borrow 
from (if this happens, then the subtrahend was actually larger than the 
minuend and we should perform the opposite subtraction and give the 
result a minus sign). 

it turns out that there is a much easier way to perform subtraction of 
binary numbers (at least as far as computers are concerned). By 
converting the subtrahend to a different format — called its comple- 
ment — we can transform any subtraction problem into an addition 
problem. This proves to be quite efficient and it also solves another 
problem — that of writing negative numbers. 


Negative Numbers 


There often comes a time when we must express a number less 
than zero. We have learned to write such negative numbers by placing 
a small minus sign in front of the first digit. Then when we add negative 
numbers to positive numbers, we actually perform subtraction on the 
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negative ones. While this seems to work conveniently for humans, the 
computer has no comprehension of a minus sign. 

One way to represent negative numbers would be to use one bit of 
the number to represent the sign — say the left-most bit being zero for 
positive numbers and a one for negative numbers. Using such a 
scheme, the number 45 would be written as 00101101, while negative 
45 would be written as 10101101. Note that the first bit indicates the 
sign, leaving only seven bits remaining for the number. Thus an eight 
bit byte can represent a signed decimal number between’ ~ 127 and 
+ 127. The problem with this approach is that adding a negative and 
positive number of the same magnitude does not give zero as 
expected. That is, 


Q0101101 (+459) 
+ 10191181 (—45,.) 


11911810 (90,9) # wrong}! 


There is another way of denoting negative numbers which solves 
this problem. (While it may seem more complicated to us, it simplifies 
things for the computer.) The first step in creating a negative number 
is to complement each bit of the positive binary number. That is, 
change each 0 to a 1 and every 1 to a0. For example, the number 45 
becomes: 


06181101 (45,4) 
11918019 (each bit complemented) 


The next step is to add one to the number giving us: 


11919019 
ts Sal 
11919011  (—45,,) 


This result is called the twos complement of the original number. We 
will use it to represent negative numbers. Just to be sure that you 
understand, let’s calculate the twos complement of a couple more 
numbers: 
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91198191  (101,,) (217,49) 11811901 
198119190 @ complement » ‘981901128 
+ 1 4 add one > + 1 
19811811  (—101,9) (—21749) 96100111 


The twos complement of a number has great significance for binary 
numbers. For one thing, it has the correct property of negative num- 
bers in that adding any negative number to its positive counterpart 
yields a result of zero: 


90101101  (+45,,) 
+ 11919811  (—45,,) 


198898096 = (G, ignoring carry) 


Notice that the result does equal zero if we ignore the carry into the 
next higher position. Actually it is quite easy to show that adding any 
number to its twos complement equals zero, according to the way in 
which we have derived the twos complement number. Since we 
started by taking the complement of the number, it should be obvious 
that any number plus its complement equals abinary 11111111, 
for example: 


96101101 @ any number 
+ 11918818 4 plus its complement 


11111111 4 equals all ones 


Therefore adding the twos complement to a number must equal this 
plus one or: 


114111111 
5 ee 


199000900 


This proves that the twos complement notation satisfies the condi- 
tion that adding any number to its negative value equals zero. Further- 
more we can show that adding any numbers, regardless of their signs, 
may be accomplished with this scheme. For example: 
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001011081 (+4540) 
+ 11119118 (—104,) 


90190011  (+35,,) 


Notice again that when dealing with negative numbers we will ignore 
any carry out to the ninth binary place. Since twos complement 
notation correctly follows the algebraic rules for negative numbers, it 
becomes the natural choice. It also makes a separate subtraction 
operation unnecessary. To subtract two numbers, simply form the 
twos complement of the subtrahend and then add. 


Binary Fractions 


What happens when we need to express numbers less than one but 
greater than zero? In modern thinking, these are known as fractions. 
You probably know two different ways of expressing fractions. One 
way is to divide the whole number “1” into several equal parts and 
then express how many of these portions there are. For example, we 
might say add “one-third” of a cup of sugar. When the partial units 
chosen become a negative power of the base 10 system, we can then 
express the number as a decimal fraction. For example, one-tenth is 
commonly written as 0.1 where the decimal point signifies that the 
numbers to the right are fractions. 

We extend the decimal system by adding places for the negative 
powers” of ten as shown in Fig. 2—4. The same thing applies to the 
binary number system as shown in Fig. 2—5. Table 2—1 lists some of 
the negative powers of two. 


Multiplication 


As previously mentioned, the Z80 CPU does not know anything 
about multiplication or division. The only mathematical functions that it 
can perform directly are addition and subtraction. However, it is quite 
easy to show the relationship between these four operations. 


*Raising a number to a negative power is equivalent to dividing by the number raised to 
the positive power (e.g., 10-3 = 1/108). 
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Multiplying any number A by another number B, is equivalent to 
adding A to itself B times or adding B to itself A times. That is: 


a 


B times A times 
AXB = A+A+...+A = B+B+...4+B 


6x3 = 64646 = 34343434343 = 18 


So far so good, as long as we are dealing with small (one digit) 
numbers. But when we try to multiply 46 x 1023, this simple addition 
approach becomes unwieldy: 


<< ———= — 102, OR 100 POSITION 


101 OR 10 POSITION 
10° OR 1 POSITION 


DECIMAL POINT 


10-1 OR 0.1 POSITION 
i 10-2 OR 0.01 POSITION 
2 5 


aa 5x0.01= 0.05 


2x0.1 = 0.2 
9x1 = 9 
4x10 = 40 
3x 100 =300 
349.25 


Fig. 2-4. Extending decimal notation to include fractions. 
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1023 times — whew! 
TELE YS TS 
46x 1023 = 46+46+464+464+ ... +46 


37 


Even if we could add two numbers per second, it would take quite a 
while to perform this simple problem. As you already know however, 
there is an easier way to multiply multidigit numbers. This process 


relies on our definition of such numbers: 


46 = 4x10 +6 | 


OR 128 POSITION 
OR 64 POSITION 
OR 32 POSITION 
OR 16 POSITION 
OR 8 POSITION 
OR 4 POSITION 
OR 2 POSITION 
aes OR 1 POSITION 
BINARY POINT 


1110014104. 041 
| = 0.125 = 
Ox 0.25 
, ix 05 
1x 1 
-Ox 2 
tx 4 
Ox 8 
Ox 16 
1x 32 
1x 64 
1x 128 


2-10R1/20R0.5 POSITION 


2-20R 1/40R 0.25 POSITION 
| a 2-3 OR 1/8 OR 0.125 POSITION 


0.125 


128 
229.625 


Fig. 2-5. Extending binary notation to include fractions. 


38 Timex/Sinclair 2068 Intermediate/Advanced Guide 


Therefore: 


1023 x 46 = (1023 x 4) x 10 + 1023 x 6 


a 


That is, we break down one of the multidigit factors into its component 
parts. This reduces the problem to a series of single-digit problems 
which are easier to perform. We can then add the results of these 
simpler problems, keeping track of their relative weights, to arrive at 
the final answer. Thus we would write: 


1023 4 multiplicand 
x 46 4 multiplier 


6138 (61023) partial 
4092 (4x1023) products 


47058 € product 


Note that the second partial product is shifted over one place to the 
left. This gives it the proper weighting factor (x 10) necessary for the 
addition of the two partial products. 

Binary multiplication is probably the simplest of all, as evidenced by 
the two-number equations next: 


x xX X X 
~OQ-B 

| Il 
=~oeQ2Q0 


Noll 


Note how this corresponds to the function of an anp gate. Another way 
of looking at this is to say that zero times any number equals zero and 
that one times any number equals that number. This should sound 
reasonable since the same is true in the decimal system. But since the 
binary system stops at 1, we do not have any further multiplication 
“tables” to worry about. This also eliminates the problem of “carries” 
from one digit to another. Therefore, to multiply two binary numbers 
we proceed like so: 
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1911181 — (93,¢) 
x 10118 (2245) 


GBBOOOB 
1811191 
1811191 partial products 
GBGGOGOO 
16111981 


11111111119  (2046,,) 


Notice that every partial product will be either all zeros or the 
multiplicand itself. There is never any carry during the multiplication 
although there may be when adding up the partial products. Thus the 
multiplication of binary numbers can be reduced to three simple steps: 


1. Checking the value of each bit in the multiplier 
2. Shifting a binary number to the left 
3. Adding the result 


As we will show in Chapter 12, these steps are quite easy for the 
Z80 to perform. With the proper machine language code, any size 
binary numbers can be multiplied. Finally, note that whenever two 
numbers are multiplied (in any number system), the resulting product 
can have as many digits as the combined total of the numbers being 
multiplied. In a computer, this means that multiplying two 8-bit num- 
bers can yield a 16-bit result. Whenever negative numbers are to be 
multiplied, they are first changed to their positive values. After the 
multiplication is performed, the sign of the result is determined by the 
standard rule — if both signs were the same, the result is positive, 
otherwise the result is negative. In this latter case, the result is then - 
converted back into its twos complement form. 


Division 

Division can be defined in terms of a similar process using subtrac- 
tion. We won't bother with all of the details, but simply state that the 
number of subtraction operations possible (before the dividend goes 


negative) becomes the quotient. Anything left over becomes the 
remainder. We can even use the standard division notation: 
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191 € quotient 


191 | 11818 4 divisor/dividend 
101 


0011 
9000 


112 
101 


1 @ remainder 


There are many ways to program the Z80 to perform binary division. 
We'll give one example in Chapter 12. 


THE HEXADECIMAL NUMBER SYSTEM 


Writing binary numbers can get tedious and difficult to read. A 
common “shorthand notation” involves grouping the binary number 
into four-bit chunks. Thus an eight-bit number would break down into 
two chunks. With four bits, there are 16 possible values for any chunk. 
If we try to represent them by the decimal numerals 0-9, it leaves us 


with 6 more values but no more numerals. We need more symbols, so . 


we turn to the letters of the alphabet. The next value becomes A 
followed by B etc. up to F. This is the basis for the base 16, or 
hexadecimal number system. Table 2-2 shows the decimal/hexa- 
decimal relationship. When writing hexadecimal numbers, we will 
often add the letter h to indicate the base rather than using a sub- 
scripted number 16. Thus 3Bh is the same as 3B,.. 


Converting Hexadecimal to Decimal 


Converting hexadecimal to decimal is very similar to converting 
binary to decimal. Instead of using the binary weight factors; we now 
use powers of 16 as shown in Table 2-3. Thus: 


1AE = 1x 167= 1x 256= 256 
Ax 16'= 10x 16= 160 
Ex 16% 14x 1= _14 


430 
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Table 2-2. Hexadecimal Number System 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 


AMOAWDODMIMHRwWNHO 


Table 2-3. Powers of 16 


0.0625 
0.00390625 


0.000244140625 © 


0.0000152587890625 
0.00000085367431640625 
16777216 0.000000059604644775390625 


Converting Decimal to Hexadecimal 


The same thing holds true for converting decimal numbers to hexa- 
decimal. You can use the subtraction method as in Fig. 2—3 or you can 
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write the conversion like a division problem with changing divisors: 


1AE,, : 
1 16 256 | 430 
256 Note: All numbers are in 
174 base 10 except quotient. 
160 
14 


OTHER BINARY REPRESENTATIONS 


So far, we have shown how binary representations are used for 
writing numbers between 0-255 or signed numbers between — 127 to 
+127. Obviously a computer must deal with other forms of data. 
Three major formats are used by almost all personal computers. The 
simplest involves assigning each of 128 binary values to represent 
each letter in the alphabet including numbers and punctuation. In this 
way, any type of written information can be stored within the computer 
in binary form. As with almost all coding schemes, there is no correct 
code, but the most popular is the ASCII code as shown in Appendix A. 
The T/S 2086 uses ASCII code to store characters. It also assigns the 
unused codes and the remaining 128 possible byte values to repre- 
sent graphic characters, special operations, and the BASIC key- 
words. The entire character set for the T/S 2068 is shown in Table 
2-4. 

Another data structure can be used to store integer numbers 
greater than 256. This requires more than eight bits, so we use two 
complete bytes. This gives us 16 bits to work with for a total of 65,536 
different values. This should suffice for all but the largest numbers. 

Numbers greater than 65,536 require more bytes to store them. To 
represent very large numbers, another number format is used. This 
format is called scientific notation and we will show how the computer 
handles such numbers in the next chapter. 

Finally, when we introduce machine language programming we will 
come across another form of binary representation called binary 
coded decimal (BCD). This notation allows two decimal numbers to be 
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Table 2-4. T/S 2068 Character Set (ASCII Compatible) 


Code Character Code Character 


Not used 
Not used 
Not used 
Not used 
Not used 
Not used 
PRINT comma 
EDIT 

Cursor Left 
Cursor Right 

18 Cursor Down 

11 Cursor Up 

12 DELETE 

13. ENTER 

14 Number (slug) 

15 Not used 

16 INK control 

17. PAPER Control 
18 FLASH Control 
19 BRIGHT Control 
28 INVERSE Control 
21 OVER Control 

22 AT Control 

23 TAB Control 

24 Not used 

25 Not used 

26 Not used 

27 Not used 

28 Not used 

29 Not used 

38 Not used 

Not used 


OAN DORON BQ 
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Table 2-4 —cont. T/S 2068 Character Set 
(ASCII Compatible) 


® 


A 
B 
Cc 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
O 
P 
Q 
R 
s 
T 
U 
Vv 
Ww 
xX 
Y 
Z 
[ 
/ 

] 
- 
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Table 2-4 —cont. T/S 2068 Character Set 
(ASCII Compatible) 


Code Character Code Character 


SRR See ees 


(i) 
153 (j) user 
(k) graphics 


46 
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Table 2-4 — cont. T/S 2068 Character Set 
_ (ASCII Compatible) 


RESTORE 
NEW 
BORDER 
CONTINUE 
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“packed” into an 8-bit byte as shown in Fig. 2-6. While this is not as 
efficient as true binary notation, it can eliminate errors that creep in 
during the binary/decimal conversions. (With binary fractions for 
instance, we often have to round off to a fixed number of binary 
places.) . 


BINARY 7 BINARY 4 
74p= |O 14 410 1 0 0 


Fig. 2-6. Binary Coded Decimal notation. 


| 3 | 
Exploring the T/S 2068 
BASIC 


T/S 2068 OPERATING SYSTEM 


When the T/S 2068 is first turned on, a few horizontal bars appear 
on the screen, possibly some flashes, and then the title page comes 
up with the Sinclair and Timex copyright notices. You may have 
assumed that the computer was just warming up, like the picture tube 
does in your tv set. Actually, there are no parts inside the T/S 2068 that 
need to warm up to operate. The instant that you turn on the power, the 
computer begins executing a program called the operating system 
that resides inside the computer in ROM. 

With few exceptions, whenever power is applied to the Z80, it 
attempts to execute a program. In a sense, the CPU is like a robot 
blindly carrying out its duty. It looks at an internal counter to see what 
memory address holds its next instruction, reads that instruction, and 
then tries to perform whatever function is called for. As we will see in 
Chapter 4, the Z80 CPU can be forced to begin executing its program 
at the start of memory, namely address 0000. By placing ROM at this 
address, the computer can be made to perform in a predictable 
manner. Every time the computer is turned on it will begin executing 
whatever program is stored in the ROM. 


Initialization 


In the T/S 2068, ROM contains a program that initializes the com- 
puter and sets it up to accept commands typed on the keyboard by the 
user. Even after the copyright page has been displayed and the 
computer just seems to be sitting there, it is really still executing a 
program. 


48 
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At the same time, another circuit inside the T/S 2068 generates the 
video display that you see on your tv or monitor. This circuit uses a . 
portion of the T/S 2068's RAM to store a digital pattern similar to what 
is displayed. When the computer is first turned on, the contents of this 
portion of RAM (as well as the rest of RAM) is unknown. Almost any 
value can be present in any given RAM location. Because the RAM 
chips are very symmetrical in design, however, it is likely that many 
locations have the same value. Because of this, we usually see a 
- regular pattern on the screen, such as a few horizontal bars. 

As the initialization routine stored in ROM begins to execute, one of 
the first things it does is to check how much RAM is in the machine. In 
doing this, almost every byte of RAM is set to zero. You can easily 
check this for yourself. Turn on the computer and immediately PEEK at 
any location between 26800 and 65300. You will find a value of zero at 
all of these locations. 

Initialization of the T/S 2068 also includes checking for ROM con- 
tained in a Timex Command Cartridge. Depending on the amount of 
RAM you have in your computer, the type of cartridge (if any), and 
certain other peripherals, the initialization program partitions off sec- 
tions of RAM. Certain areas of RAM are reserved for the video display 
information, system housekeeping chores, the BASIC program and its 
variables, peripherals such as a printer, etc. If a cartridge has been 
installed, then the computer may continue by executing the program 
on that cartridge. Otherwise, the standard operating system program 
contained within the T/S 2068 will continue executing. 


By Your Command... 


After a few seconds, the initialization routine is completed leaving a 
blank screen with two copyright notices. At this point, the computer 
does not know what you want it to do, so it enters a routine that waits for 
further instructions. The only way of communicating our instructions to 
the computer is by typing them in on the keyboard. Therefore the 
major function of this routine is to determine when we have depressed 
a key and which key that is. Furthermore, this routine must keep track 
of all the keys typed until the ENTER key is pressed. This is because 
the computer cannot determine what you want it to do until the entire 
command has been entered and the ENTER key pressed. 

While the computer is waiting for you to type in a command, it takes 
care of a few housekeeping chores. These include updating the video 
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display and keeping a running “frame counter” (more on these later). 
Also, whenever. a key is pressed and held down for more than half a 
second, this routine automatically simulates the action of repeatedly 
pressing and releasing that key. This is known as the auto-repeat 
function. The actual delay before a key begins to repeat and the repeat 
rate are both controlled in software. In Chapter 15, we will show how 
these values can be changed with a simple POKE statement. 

As we continue typing in our command, the computer stores each 
character in a small section of RAM called the edit buffer. The actual 
location of this buffer changes as new commands or program lines are 
entered but the computer always keeps track of where it is. When the 
ENTER key is finally pressed, the operating system then begins to 
process the command. 

The first thing that it does is to invoke a routine called a parser which 
examines the line of characters that were typed and which are now 
sitting in the edit buffer. It is the parser’s job to figure out what com- 
mand, if any, is being given to the computer, The first task of the parser 
is to determine whether a direct command or a BASIC program line 
has been entered. This is done by looking at'the first character in the 
line. If it is a number, then the entire line is interpreted as a BASIC 
program line; otherwise, it must be a direct command. We'll discuss 
the latter case first. 

After determining that this is a direct command, the parser con- 
tinues to scan each character of the line. If the entry contains any 
syntax errors, it is reported by placing a question mark in front of the 
offending character. Assuming there are no errors, the parser then 
determines what action to take and transfers control to the proper 
routine in the system ROM. Each of the T/S 2068 commands has an 
appropriate machine language program, or subroutine, which handles 
that command. If the command requires further data such as a vari- 
able name, constant, numeric expression, etc., then the parser con- 
tinues scanning the buffer for these pieces. 


A TUTORIAL ON THE T/S 2068 BASIC INTERPRETER 


Most of the system ROM contains a program called the BASIC 
interpreter. This is the program that allows us to communicate with the 
T/S 2068 in an English-like manner. The interpreter program is written 
in machine language and integrated into the operating system. An 
interpreter program is interesting in that it allows us to write and 
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execute programs using a higher level language such as BASIC. But 
as far as the CPU is concerned, it is always running the interpreter 
program. The job of the interpreter, therefore, is to translate BASIC 
commands into an appropriate sequence of machine language 
instructions. 

One of the advantages of using a higher level language is that you 
do not have to keep track of absolute memory locations. When writing 
a program and/or storing data in the computer, everything gets broken 
down into a series of bytes. Since all 65,535 bytes look alike to the 
Z80, there is a problem in keeping track of which bytes hold what 
information. When you write programs in machine language, it is up to 
you to keep things straight. This can become very complicated and itis 
a major reason why higher level languages were developed. In BASIC 
for instance, we only have to say: 


LETa=3 


to create a variable in RAM and store the value of three there. We have 
no idea as to the exact memory location(s) where “a” is to be found, 
but we can always get the current value of the variable by simply 
referring to it as “a.” This, of course, makes programming much easier 
but limits the program's speed and versatility. One way to get around 
these limitations is to include machine language routines in your 
BASIC programs (or, of course, write the programs entirely in machine 
language)..Part Two of this book is devoted to this subject. First, 
however, we’ll examine the T/S 2068 BASIC interpreter in more detail. 

At this point, we can begin to talk about the specifics of the T/S 2068 
BASIC interpreter and how it works. Fortunately, we can use the 
computer itself to explain many of these functions. To do this, we will 
make extensive use of the PEEK and POKE statements. This is 
because we need to work with absolute memory locations and the T/S 
2068 only speaks BASIC when it is first turned on. Just to make sure 
that you understand PEEK and POKE, let's take a moment to look at 
them in some detail. 


The PEEK Command 


The PEEK command is used to look at the contents of a single byte 
in memory. Any valid address (in the range of 0-65,535) can be 
examined. It does not matter what type of memory is located at that 
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address. The Z80 CPU will simply go to that location and see what 
data is there. If there is no circuit device mapped into that address, 
then the data read by the Z80 will be meaningless. If there is RAM or 
ROM there, then the information (one byte’s worth) will be read out by 
the Z80 and then relayed to the program or display. 

Since all data read by the PEEK statement consists of one byte, the 
result will always be in the range of 0-255. This result can be printed on 
the screen by a command such as: 


PRINT PEEK @ 


The result of entering this command is the number 243 printed on the 
screen. This is the value stored at that location and it will always be 
there. That is because this data is stored in ROM and therefore all T/S 
2068s will display the same results. There are actually over 16,000 
bytes to choose from for which we can predict the PEEK results. 

The result from a PEEK can also be assigned to a variable, for 
example: 


LET a = PEEK 19990 


Quite often, computers must deal with numbers greater than 255. A 
16-bit memory address, for example, requires two adjoining bytes. 
One byte holds the lower eight bits of the address or the /east signifi- 
cant byte. The next memory location then contains the upper eight 
bits or the most significant byte. These are also referred to as the low 
and high bytes respectively. Although we would normally write the 
high byte first followed by the low byte, in most cases, the computer 
finds it more convenient to store the low byte first. It is the location of 
this byte that is usually referred to when describing the location of a 2- 
byte number. The high byte is therefore found at the next higher 
memory location. 

When using the PEEK function to examine a 16-bit number, we must 
use the formula: 


PEEK n + 256 * PEEK (n+1) 


For example, to find the starting address of a BASIC program in the 
T/S 2068, we would type: 


PRINT PEEK 23635 + 256 * PEEK 23636 
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The POKE Command 


The POKE command allows us to place whatever value we desire 
into any RAM location. Although we could POKE to any valid memory 
address, unless there is RAM located at that address (or some other 
device capable of storing information) the data POKEd will be lost. For 
example, if we POKE to a ROM location, nothing much will happen. 
Try: 


POKE 0:9 


Then: 
PRINT PEEK @ 


Note that the data at location 0 has not changed from the previous 
PEEK. This data is permanently stored in the computer's ROM and 
cannot be changed. Also note that the POKE command requires two 
parameters: the address to be changed and the data to be put there. 
Again, the address must be valid (0-65,535) as well as the data 
(0-255). Otherwise, an “integer out of range” error will be reported. 

If we try the last example with a “good” memory address (i.e., one 
containing RAM and not reserved for system use), we can verify the 
results of a POKE command. 


POKE 30009 +19 

PRINT PEEK 38009 

POKE 39999 +33 

PRINT PEEK 30200 
etc. 


There are many ways to POKE 16-bit numbers, but none of them are | 
elegant. One way to POKE a 16-bit value “data” into the two bytes 
starting at “address” would be: 


LET temp=INT (data/256) 
POKE address, data-temp*256: POKE address +1, temp 


Now that we have the digging tools (PEEK and POKE), we are ready 
to explore the inner workings of the T/S 2068 BASIC. Our exploration 
will be divided into two parts since there are two parts to any BASIC 
program: the program itself and the variables, or data, that it uses. 
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These two items are stored in different areas of the computer's RAM 
and the first job will be to find out where they are. Their location 
depends on a variety of factors, and indeed, as we use the computer 
(entering program lines for example), these areas can even move 
around! Fortunately, we know that the computer must keep track of 
their location. It does this by maintaining a table of pointers, sort of an 
index, to various memory locations that it needs. These pointers are 
stored in the RAM area reserved for system use. A complete list can be 
found in Appendix D of the 7/S 2068 User Manual, but for now we will 
only be concerned with two of them. The first is called PROG and is 
located at address 23635 (plus 23636, since it is a two-byte number). 
This pointer always indicates the memory location where the image of 
your BASIC program resides. We will cover this in more detail later. 

The other pointer we will need is called VARS. As you might guess, 
this tells us where the variables are located. By the way, names such 
as PROG and VARS are used only for convenience — to help you 
remember what they are used for. These terms have no special 
meaning to the computer. 


VARIABLE STORAGE 


CAUTION: As you follow along with your computer, it is imperative 
that you enter each example precisely. Do not skip any or try some 
different wording. If you do, the memory addresses given will not be 
valid. 


Integers 
if we type the command: 


LETa=1 


into the computer we know that the BASIC interpreter will have to 
create a variable called a and give it a value of 1. Creating a variable is 
really nothing more than setting aside some memory for its value and 
keeping track of the variable’s name and where it is located. An easy 
way to do this is by keeping all variables together in a sort of list. That 
is, as more variables are needed, simply add them to the bottom of the 
list by placing them in the next higher memory location. Then as long 
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as we make it clear where one variable starts and another ends, we 
only have to keep track of the starting address for this list. 

This is exactly what the T/S 2068 does as we will demonstrate with 
the following exercise. When the computer. has just been turned on, 
there will be no variable list, since no variables have been defined yet. 
The beginning address for this table has been determined, however,. 
and we can find this out by entering: 


PRINT PEEK 23627 + 256 * 23628 


The number 26710 should appear after you press ENTER. Thus the 
number 26710 is the-starting address for a list of variables to be stored 
in memory. To place some variables into the list we can start by 
entering: 


LETa=1 


The computer responds with: 


@OK,O:1 


which, of course, just means that it has finished your command and 
there were no errors. Although nothing else appears to have hap- 
pened, we can check that a variable called ‘a’ has in fact been created 
with a value of 1. 

Since we know the starting address for the variable list, it stands to 
reason that the variable “a” should be found there. So type: 


PRINT PEEK 26719 


If you’ve done everything correctly so far the result should be 97. If we 
check the T/S 2068 character set in Table 2-5, we will find that 97 is 
indeed the code for the letter “a.” So it would seem that the first byte 
represents the name of the variable. The value of “a” must also be 
stored here, so let's do a few more PEEKS: 


PRINT PEEK 26711 (@) 
PRINT PEEK 26712 (@) 
PRINT PEEK 26713 (1) 
PRINT PEEK 26714 (8) 
PRINT PEEK 26715 (@) 
PRINT PEEK 26716 (128) 
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The number in parentheses is the result you should get from enter- 
ing each statement. Typing in all of those PRINT statements is a bit 
tedious. You may have realized that it could be done easier by using a 
FOR ... NEXT loop. This is true, but it would require us to define 
another variable which we don’t want to do quite yet.:And, if you had 
tried this by writing a BASIC program, the entire variable list would 
move to a completely new location in memory! 

Before we explain the results of these PEEK statements, it is impor- 
tant to realize that there are three types of variables allowed in BASIC: 
whole numbers (integers), real numbers (floating point), and strings 
(characters). Each of these variable types use a different format for 
storing its value. Furthermore, there are slightly different versions for 
variables with single character names as opposed to longer names. 
Finally, we will also examine the structure of numerical and string 
arrays. 

Getting back to our previous results, we can generalize the storage 
of any single-letter, numeric variable within the T/S 2068 as shown in 
Fig. 3-1. 

The first byte equals the ASCII code for the letter which is the 
variable name. Fig 3-1 shows this in a slightly different fashion: 


Coa ees 
ES, 
letter — 60h 


ONE-BYTE : | 
VARIABLE NAME FIVE-BYTE INTEGER OR REAL NUMBER VALUE 


0 1 1 LETTER-60h 
Sen ‘ate yoenree 


Fig. 3-1. Data structure for numeric variable with single letter name. 


The reason for this format will become clear.as.we discuss the other: 
types of variables. In this case, however, we can note that placing the 
three bits 011 in front of any 5-bit value is equivalent to adding 
01100000 to that number. Converting to hex, we find that this means 
adding 60h. Therefore, adding 60h to “letter — 60h” just means that 
the letter is stored as is. 
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BYTE 1 BYTE 2 BYTE 3 BYTE 4 BYTE 5 


eo SS 


ALWAYS 0= POSITIVE 16-BIT VALUE ALWAYS 
ZERO FFh = NEGATIVE (LEAST SIGNIFICANT ZERO 
(SIGNIFIES ‘BYTE FIRST) 
INTEGER VALUE) 


Fig. 3~2. Data structure for an integer value (— 65535 to + 65535). 


We will be using this technique of subtracting 60h from a letter’s 
ASCII code, so it does deserve some explanation. Since a variable 
name must always begin with a letter, the first (or only) character in a 
variable name can only take on 26 different values. This is also due to 
the fact that the T/S 2068 treats upper-case and lower-case letters as if 
they were the same (as far as variable names are concerned). Since 
we only need 5 bits to describe 26 different items, the T/S 2068 steals 
the remaining 3 bits of the first character in a variable name for 
indicating what type of variable it is. 

For any numerical variable (integer and real) the next five bytes hold 
the current value for that variable. In our example, the next byte is a 
zero and this indicates that the value is stored in integer format. Fig. 
3-2 outlines the significance of each byte in an integer data element. 

Following the zero is a byte that represents the sign of the integer. It 
will be zero if the number is positive, 255 (FFh) if the number is” 
negative. The next two bytes represent the lower and then higher byte 
of a 16-bit value. In our example, if we write the two bytes together we: 
would get a value of 01 2... which, of course, is equal to the number 1. 
This agrees with the value that we previously assigned using the LET. 
Statement. In general, the higher byte must be multiplied by 256 and 
then added to the lower byte to determine its decimal value. 

‘The fifth remaining byte of an integer variable will always be zero as 
confirmed by the PEEK 26715. Finally, there is the value 128, which is 
the last byte at which we ongneny t PEEKed. This is used to signify the 
end of the variable list. 

If we now type: 


LETb = -2 
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then a second variable, ‘b’, should get added to the list. Check this by 
typing: (1 promise after this we'll use a FOR . . . NEXT loop): 


3 


PRINT PEEK 28716 (98) b 

PRINT PEEK 26717 (B) integer 
PRINT PEEK 26718 (255) negative 
PRINT PEEK 26719 (254) 2 
PRINT PEEK 26720 (255) 

PRINT PEEK 26721 (8) always zero 
PRINT PEEK 28722 (128) ; end of table 


We've added some comments on the right to illustrate the results. As 
you can see, the 128 at location 26716 has been replaced by a 98 
which is the code for the letter b. The next byte is zero, signaling that 
an integer value follows. The next byte is 255 which indicates that the 
number is negative. The following two bytes when taken together form 
the integer value. But 255 * 256 + 254 certainly does not equal 2. As 
you may have guessed, the T/S 2068 stores a negative number using 
its twos complement. notation. Check for yourself that this value is 
indeed the correct result for a negative two. One way to determine the 
decimal value of a negative integer is to subtract 131,072 from its 
unsigned value (e.g., 255 x 256 + 254 = 131,070 — 131,072 = —2). 

A good question to. ask at this point might be: Why use five whole 
bytes to store a number that could be put into two bytes plus one extra 
bit? In fact, most other computers limit integers to one half of this range 
(i.e., - 32768 to + 32767) and thereby only require two bytes for each 
integer. The only possible answer is that it makes integer storage more 
compatible with that of floating point numbers. These are described 
next. 


Floating Point 


Many times we need to work with numbers larger than 65,535. 
While we could always add more bytes to represent numbers of any 
given size, it becomes much too inefficient as the number gets very 
large. Furthermore, we also need some way to signify fractions such 


as ¥2. The solution to both of these problems is to use scientific 
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notation. Numbers stored this way are also called floating point num- 
bers. 

You may already be familiar with this technique from working in 
BASIC. Whenever the computer needs to display a very large, or very 
small number, it uses the form: ; 


x.yyyyE+nn 


Where x.yyyy represents the mantissa and nn is the exponent. Of 
course, we know that this is read as x.yyyy times ten to the nn power. 
You should be able to see that scientific notation lets us represent very, 

-very large (or small) numbers, although only a few significant figures 
are retained. 

The same procedure can be applied to writing binary numbers. Only 
now the exponent represents powers of two instead of ten. If we assign 
one byte to represent the exponent, then we would have a range of 
0-255. We also need to consider negative exponents. A convenient 
way to deal with this is to add 128 to the exponent before storing it and 
then subtract it again to retrieve the correct number. Then the expo- 
nent can have a value between — 128 and + 127. Raising two to these 
powers gives us an equivalent range of about 10E —30 to 10E+30. 
This should certainly prove adequate for most jobs. 

Therefore, whenever a number is too large to be stored as an 
integer, or if it contains some fraction, binary scientific notation is used. 
First the number must be normalized which means converting it to a 
mantissa between ‘/% and 1. (This is equivalent to how we normalize 
decimal numbers in scientific notation — where we require the number 
on the left of the decimal point to be between 0 and 10). Ifthe mantissa 
is not already in this range, it is multiplied or divided by 2 as many 
times as necessary until it is. Each time this is done, the exponent is 
decreased or increased by one, to keep track of the correct value. With 
the mantissa normalized and the correct exponent calculated, we are 
almost ready to determine how it will be stored in memory. 

First of all, we can arbitrarily decide how many bytes to use for the 
mantissa. Many numbers will have an infinitely long mantissa just like 
the decimal form of % is .3333 .. . Therefore, many numbers will 
require that the mantissa be rounded off to a fixed number of digits. In 
the T/S 2068, floating point numbers are stored with a 4-byte, or 32-bit 
mantissa. Thirty-two bits lets us represent numbers as high as 
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EA ONENT FOUR BYTES 


+128 


Fy 
ge 
EXPONENT 32 BIT MANTISSA 
{LEADING 1 IMPLIED) 
SIGN BIT 
(0 = POSITIVE) 
(1 = NEGATIVE) 


Fig. 3-3. Data structure for floating point value. 


4,294,967,296 which means that we will have the equivalent of over 9 
decimal-place accuracy. 

There is one more point to consider and that is the overall sign of the 
number. We know that the sign of the exponent has been accounted 
for by adding 128 to it. It turns out that the first bit in the mantissa will 
always be a one (since the mantissa has been normalized to a number 
great than % or 0.1 in binary). Therefore, this bit really does not need to 
be stored. In its place, we can then put a sign bit — 0 for positive, 1 for 
negative. At last, we can show the general form for storing a floating 
point number (see Fig. 3~3). 

To check this on the computer, type: 


LET c = 1/19 


and then: 
FOR i = 28722 TO 26727: PRINT i» PEEK i: NEXT i 


Notice that we type this entire line as an immediate command (i.e., 
without a line number). By now you should understand why. Your 
screen should now look like this: 


26722 99 c 

28723 125 —3 (+128) 
26724 76 

28725 204 

26726 204 1100... 
28727 205 


To understand these numbers, let's calculate what “o should be in 
binary notation. Referring back to Chapter 2, we can calculate that: 
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Yo = 0.0001100110011001100 ... 


Normalization of the mantissa is really easy to perform. Simply 
count how many piaces to the right of the binary point we must go to 
reach a 1. In this case, there are three so the exponent will be 128 — 3 
= 125. Moving the binary point over, we now have a mantissa of: 


.1180119811901100 ... 


Because we only have 32 bits, the mantissa is rounded off to that many 
places. Because the 33rd number is a one, the 32nd bit gets rounded 
up from 0 to 1. Finally, we drop the leading 1 and replace it with the sign 
bit, indicating that the number is positive. Thus./o would be stored as: 


01111101 91001100 11901108 11901190 11901101 


If we now convert each byte to its decimal value, we will come up with 
the exact same results printed by the computer. 
We'll now examine what happens when we add a variable whose 
name is more than one character. Type ENTER to clear the screen and 

then: 


LET dos =3 


Then: 


FOR i=26747 to 26754: PRINT i+ PEEK is NEXT i 


Your screen should now look like this: 


26747 164 d (+64) 

26748 111 ° 

26749 231 g (+128) 

26750 @ 

26751 ® 

26752 3 integer value 3 
26753 @ 

26754 @ 


Once again we will start with the general form for a numeric variable 
whose name is longer than one letter. This form is shown in Fig. 3-4. 
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a ae is aoe meee | SS a es | a See 


LETTER-60h 2ND CHARACTER LAST CHARACTER VALUE 


Fig. 3-4. Data structure for numeric variable with multiple character 
name. 


The most important difference here is in the way the first letter is 
stored. The first three bits have been changed from 011 to 101. This is 
the signal that the T/S 2068 uses to distinguish between single and 
multicharacter variable names. Subtracting 60h from a character and 
then adding 101 in front of it is the same as adding 64 to the ASCII 
code. After placing the first letter in memory in this fashion, the 
remaining letters or numbers in the name are added in sequence. The 
normal 7-bit ASCII code for each additional character is used with the 
eighth, most significant bit set to zero. Since variable names in the T/S 
2068 can be of any length, we will also need some way to determine 
which byte holds the last character of the variable name. For this 
purpose, that eighth bit proves to be most convenient. By setting ittoa 
one, the computer can indicate that this is the end of the variable name 
and that the value follows. The next five bytes then contain the integer 
or floating point value, as previously described. 


Numeric Arrays 


There is one more type of numeric variable to consider and that is 
single or multidimensional arrays. To store an array, The T/S 2068 
starts as usual with the variable name (array names are always a 
single letter). This time, the first three bits are set to 100, indicating that 
the following bytes hold information about an array. This is equivalent 
to storing the code for the letter plus 32. Next come two bytes which tell 
the computer how many more bytes follow that are associated with this 
array. The next byte holds the number of dimensions, or how many 
subscripts are used to identify a given element in the array. Next follow 
pairs of bytes, specifying the size of each dimension as declared when 
the array was DIMensioned. After storing the last dimension size, the 
actual elements follow, each using five bytes to store a value in either 
integer or floating point format. All of this is shown in Fig. 3-5. 
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5 BYTES 
2 BYTES. 2 BYTES [ | 2 BYTES EACH 


nn | Ce | ee 


LETTER-60h TOTAL NO. OF 18ST LAST ELEMENTS 
NUMBER DIMENSIONS DIM DIM 
OF BYTES 
FOLLOWING 


Fig. 3-5. Data structure for numeric array. 


The order in which the elements are stored can best be viewed as 
removing the commas from the subscript and then going in ascending 
numerical order. For example, the elements of a 2 x 3 array called ‘b’ 
would be stored:in the order: 


b(1,1)b(1,2)b(1,3)b(2,1)b(2,2)b(2,3) 


Here is a little test to demonstrate the storage of an array. Type 
ENTER so that the screen will clear. Then type: 


DIM e(2) 

LET e(irld=1 
LET e(1s2)=2 
LET e(2s1)=3 
LET e(2+2)=4 


FOR i=26755 TO 26782: PRINT i+ PEEK is NEXT i 


This will yield the following results (you will have to hit ENTER to scroll 
the display): 


26755 133 e (+32) 

26756 25 Number of bytes 
26757 v7) } to follow 

26758 Zz Number of dimensions 
26759 2 } First dimension 
26760 @ 

26761 2 Second dimension 
26762 ) } 

26763 @ 

26764 t) 

26765 1 1 e(t,1) 
26766 @ 

26767 @ 
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26768 
26769 
26776 
26771 
26772 
26773 
26774 
26775 
26776 
26777 
26778 
26779 
26780 
26781 
26782 


4 e (2,2) 


SSOBRSRBVENUBGUSASGSENSS 
wo 
a 
~~ 
XY 
a 
— 


String Variables 


Now that we understand how numeric variables are stored in mem- 
ory, it will be quite easy to describe string variables. Another simplifica- 
tion is that all string variables use single letter names. Thus we have 
only two more data structures to consider: simple string variables and 
string arrays. A simple string variable uses the form shown in Fig 3-6. 


| | Ee | 
LETTER—60h NUMBER TEXT OF STRING 
OF (MAY BE EMPTY) 
CHARACTERS. 


Fig. 3~6. Data structure for string variable. 
Notice, again, that the first three bits of the name take on a unique 
pattern so that the computer can tell that this is a string variable. Two 
more bytes are then necessary to specify the length of the string. 


Following that, we have the actual characters in order as they appear 
in the string. Simple, isn’t it? To test this out type: 


LET ?$ = “Test” 


Then: 


FOR i=26783 TO 26789: PRINT i+ PEEK i: NEXT i 
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which will yield: 


26783 
26784 
26785 
26786 
26787 
26788 
26789 


String Arrays 


Finally, we come to string arrays which are stored as shown in Fig. 


3-7. To verify this, type: 


DIM 9#(353) 
LET §$(1)="one” 


LET 9#(2) 
LET 3$(3) 


"Gag" 
="three” 


FOR i=26799 TO 26807: PRINT i+ PEEK i: NEXT i: 


1 BYTE 
2 BYTES 1 BYTE 2 BYTES f ! 2 BYTES EACH 


le es ee SS SS 


LETTER -60h 


TOTAL 
NUMBER 
OF BYTES 
FOLLOWING 


NO. OF 
DIMS 


1ST 
DIM 


LAST ELEMENTS 
DIM 


Fig. 3-7. Data structure for string array. 


This will give: 


26790 
26791 
26792 
26793 
26794 
26795 
26796 
26797 
26798 
26799 
26809 
26801 


g (+96) 


Number of bytes 
to follow 


Number of dimensions 


First dimension 


} Second dimension 


+o 3 0 
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26802 119 w 
26803 111 o 
26804 116 t 

26805 104 h 
26806 114 r . 
26807 128 end of list 


Notice that the last byte is 128, which is the flag to signal the end of the 
variable list. This shows that the string “three” has been truncated to 
“thr” because we DIMensioned g$ for a length of 3. If we were to lay out 
the current variable list it would look like Fig..3-8. 


VAR 


Pt Ba | ue ath i 


MEMORY | | | | | 
LOGATION —~ 26710 -26716=-26722-«S«(26728 26747 26755 


(DECIMAL) 
END OF 
VARIABLE LIST 
| 
e (dimensions) — e(1.2) e(1.1) (2.1) (2.2) Ig(dimensions) one twothr et 
| | | | 
26755 26783 26790 26807 


Fig. 3-8. Typical variable list. 
MORE SIGNIFICANT BYTE 
LESS SIGNIFICANT BYTE 


oS 
er rrcclineneenene! nyeneed a Nay 


a ee 

LETTER - 60h VALUE LIMIT STEP LOOPING STATEMENT 
LINE NUMBER 

WITHIN LINE 


Fig. 3-9. Data structure for FOR . . . NEXT loop variable. 


FOR . . . NEXT Loop Variable 


Did you notice that we skipped a block of memory between locations 
26728 and 26746? It is this area that we want to explore now. We will 
find that it contains information about a special type of variable: the 
control variable ina FOR . . . NEXT loop (e.g., ‘i in FOR i = 1 to 10). 

Remember when we got tired of typing in PEEK statements one ata 
time? After defining the variable called ‘c’, we used a FOR .. NEXT 
loop to print out the memory locations occupied by this variable. As we 
did this, the computer had to define a new variable called ‘i’, to keep 
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track of the loop statement. It did this by adding another entry to the 
variable list in the form shown by Fig. 3—9. Thus if we type: 


FOR i=26728 TO 26746: PRINT i» PEEK is NEXTi 


we should see: 


26728 233 i (+128) 

26729 @ 

26739 () 

26731 107 7 26731 (current value) 
26732 104 

26733 @ 

26734 @ 

26735 @ 

26736 122 26746 (limit) 
26737 104 

26738 @ 

26739 

26740 @ 

26741 1 1 (step) 
26742 @ 

26743 @ 

26744 254 } looping line 
26745 255 

26746 2 statement number 


These results should be self explanatory except for the “current 
value.” Why does it equal 26731? That is certainly not the value of ‘i’ 
after the loop has finished. (It will be 26747 since a control variable 
must always go one step beyond the control limit value in order to exit 
the loop). This value does make sense, however, when you consider 
what the value for ‘i’ was during the particular pass through the loop 
when this was printed. To PEEK at memory location 26731, the vari- 
able i had to equal this value at that point. Therefore, when the loop 
was printing out the value at location 26731, the variable ‘i’ equaled 
26731 which required that a value of 107 be at that address. 

Since we entered the command without a line number, the two bytes 
that represent the “looping line” contain a value of 65534. This, of 
course, would not be a valid line number in BASIC. The statement 
number, however, does show a correct value of two. This means that 
after each pass through the loop (i.e., when we reach the NEXT i 
statement) the computer should return to the second statement in the 
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command line. This takes us back to the statement following the first 
colon, which was the PRINT command. 


Varying variables : 


As the value for any variable changes, it will normally stay in its 
same position within the variable table. This is true even if the value 
changes from an integer number to a floating point. For example, type: 


LET dog = «l 


Then: 


FOR i=26747 TO 26754: PRINT i+ PEEK is NEXT i 


This will give: 
26747 164 d (+64) 
26748 lil fo) 
26749 231 g (+128) 
26750 125 
26751 76 
26752 204 real value 0.1 
26753 204 
26754 205 


Compare this with our earlier results. Notice that the variable dog now 
has a new value which is in floating point format. You can also see that 
the value is identical to that of the variable c. This, of course, just 
proves that Yo is equivalent to .1 

There is one exception to the rule of variables staying in the same 
place. This comes about because we allow simple string variables to 
change in length as they are assigned new values. For example, let's 


type: 


LET f# = “Examination” 


There is no way for the computer to replace the old value with the new 
one at the same location. This is because we only have four bytes 
holding the old value “Test” and the new value, “Examination” requires 
11 bytes. We can’t just add on a few more bytes because that would 
begin to run into the next variable on the list, in effect, wiping it out. The 
only solution is to create a new variable entry for f$ at the end of the list. 
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But what about the old entry for f$? It would certainly be confusing to 
have more than one entry in the list for the same variable. There are 
basically two alternatives to solving this problem. One method would 
be alter the first entry somehow so that it no longer looks like a valid 
variable entry (i.e., “mark” it as being unused or garbage). The other 
method would involve removing the entry completely and then moving 
the entire rest of the list up to fill in the void left by the old entry. It is 
interesting to note that the BASIC interpreters in most personal com- 
puters use the first method. This offers some advantages but has one 
major drawback. By leaving the old entries still in memory, a program 
can create a growing trail of garbage which takes up valuable memory 
space with useless information. If the program eventually uses up all of 
the available RAM, it must then go through a process known as 
“garbage collection” whereby all of these unnecessary entries are 
purged and a new clean list is created. 

Unfortunately, this process can take a considerable amount of time 
during which the normal program execution is put on hold. Many a 
novice programmer has been baffled when trying to figure out why his/ 
her program randomly seems to hang up for a few seconds (or even 
minutes!) but then continues as if nothing had happened. While this 
problem is somewhat rare (many people never experience it), the 
chances of garbage collection occurring increase with programs that 
constantly re-define string variables and with the large programs 
because large programs take up more memory, leaving less for vari- 
able storage. 

To see what has happened on the T/S 2068, type: 


FOR i=26783 TO 26789: PRINT i» PEEK i: NEXTi 


showing: 
26783 199 g (+96) 
26784 14 Number of bytes 
26785 a } to follow 
26786 
26787 3 } first dimension 
26788 i) 
26789 3 etc. 


Where the old variable f$ had been, we can now see the beginning 
of g$. That is, the old entry for f$ has been removed and the next 
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variable (in this case, g$), as well as everything else in the list, has 
moved up. Thus the T/S 2068 does its garbage collection “on the fly” 
every time a string variable changes length. To find the new location for 
f$, we can calculate 26807 (previous end of list) — 7 (number of bytes 
used in old f$ entry) = 26800. This should be the beginning address 
for the new f$ entry. 

Therefore type: 


FOR i=268090 TO 26814: PRINT i» PEEK is NEXTi 


to get: 
26800 70 f (—32) 
26801 i1 \ new length 
26802 1) 
26803 69 E 
26804 120 xX 
26805 97 a 
26806 109 m 
26807 105 i 
26808 116 n 
26809 97 a 
26819 116 t 
26811 105 i 
26812 tii fe) 
26813 1190 n 
26814 128 end of list 


A map of the variable list would now look like Fig. 3-10. Compare this 
to Fig. 3~8. 


1 tg manein OM 


26710 26716 26722 26728 26747 26755 


4 
e(dimensions) —_e(1.1) (1.2) @(2.1) (2.2) |g{dimensions) one twothr Examination 
| | 


26755 26783 26800 26814 


Fig. 3-10. Variable list after string variable is changed. 


HOW THE BASIC INTERPRETER OPERATES 


We’ve come a long way in describing how the T/S 2068 BASIC 
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interpreter stores data in. memory. Being able to reference the informa- 
tion using symbolic names (even if they’re only one character long) is 
much easier than keeping track of the absolute memory locations 
needed by the CPU. Of course, this is just a tiny part of what the 
interpreter does. 

Before leaving the subject of the variable list, we must describe one 
more thing: how the interpreter finds a given variable in the list. This 
turns out to be quite trivial, since we have satisfied the two require- 
ments that we mentioned at the beginning. That is, knowing where the 
list starts and where each variable description ends and the next one 
begins. This first requirement was taken care of by keeping a pointer in 
the reserved RAM. These locations (23627, 23628) always hold the 
starting address for the first variable in the list. As we move through the 
list, we can determine the boundaries using a few simple-rules: 


e Simple, single character variables always take up 6 bytes. 

@ String variables can be of any length but the actual length is 
always stored in the 2 bytes following the variable name. 

@ Arrays also contain 2 bytes following the name, to indicate how 
many more bytes are used. 


Therefore, whenever the BASIC interpreter is asked to find the value 
of agiven variable, itcan make a linear search through the variable list. 
This means that it starts at the top of the list and checks the name of 
the desired variable with the name of the first entry. If these do not 
match, the interpreter calculates where the next variable begins and 
then checks its name. As long as there is no match, the interpreter will 
keep hopping down the list, checking each entry. If it eventually finds a 
match, then the value can be read out (or a new value put in). If the end 
of the list is reached without a match, then a “variable not found” 
message is displayed. If, however, the command is allowed to create a 
new variable (e.g., LET, FOR, INPUT, etc.), and no such entry already 
exists, then a new entry is made at the end of the list. 

It is important to note that variables in the list are kept in the order 
that they were created. This gives us an important clue for speeding up 
BASIC programs. Since the interpreter will have to perform a search of 
the list each time a variable is referenced, those variables that are used 
most often should be defined first. They then will be at the top of the list 
for quick access by the interpreter. 
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This completes our discussion of how variables are stored in mem- 
ory. We are now ready to investigate how BASIC programs themselves 
are stored in memory. 


PROGRAM STORAGE 


If you’ve followed everything so far, then you will have no trouble - 
understanding the way BASIC stores programs in memory. Compared 
to the ways in which variables are stored in memory, program storage 
is much simpler. In fact, every line of a BASIC program is stored in the 
same fashion. The general form is shown in Fig. 3-11. 


MORE SIGNIFICANT BYTE 


[Pe SIGNIFICANT BYTE 


2 BYTES 2 BYTES ica SO {foo eors 04 


arian ENG TIOE| OF = ENTER 
NUMBER TEXT + ENTER 


Fig. 3-11. Data structure for a BASIC program line. 


As we mentioned before, whenever. you hit the ENTER key, the 
preceding characters are examined by the parser. If there are no errors 
and the first character on the line is a number, then the parser 
determines that this is a BASIC program line. The interpreter then 
places the line into a special area of memory set aside for the storage 
of BASIC program lines. 

Actually, the BASIC program is stored in memory in much the same 
way as variables: To begin with, each line is stored consecutively in 
what we could call the BASIC program list. The beginning address for 
the list is kept in a pointer called PROG (within the reserved area of 
RAM). Instead of variable names, we keep track of program lines by 
their line number. Since each program line can be anywhere from 1 to 
65K characters long, we add two bytes to specify its length. This is 
identical to what we did with string variables. The only major difference 
with the way program lines are stored is that they are always kept in 
numerical order according to line number. Thus if the program has line 
numbers, 10, 20, 30, and 40 and we add a line number 25, it gets 
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sandwiched in between 20 and 30. Of course, you probably have seen 
this whenever you LIST a program. 

Let's take a closer look at how the text of our BASIC program lines 
are kept in memory. For the most part, the text is Stored exactly as it 
appears on the screen. One exception is that key words (PRINT, 
NEXT, GO TO, etc.) are stored using a single byte, or token. This saves 
considerable memory space over storing each character in the key 
word as a single byte. These tokens are part of the character set as 
shown in Table 2-5. 

To start our investigation using the computer, type: 


NEW 


so that we're all at the same starting point. Now type: 


10 REM hello 


With a program line entered into memory, the next step is to find the 
starting address of the program image. We know this will be found at 
locations 23635-6 so we type: 


PRINT PEEK 23635 + 256 * 23636 


The answer comes up 26710. With this information, we can now type: 


FOR i=26719 TO 26720: PRINT i» PEEK i: NEXTi 


This displays on the screen: 


26710 1) } 10 (line number) 
26711 10 

26712 7 } 7 (length of text) 
26713 @ 

26714 234 REM token 
26715 104 h 

26716 161 e 

26717 108 I 

26718 1908 I 

26719 111 oO 

26729 13 ENTER 


A couple of notes are in order here. First, notice that the line number 
bytes are stored with the most significant byte first. This is the opposite 
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of most other two-byte storage. Next, note that the line count includes 
the ENTER key (and it is stored in memory). Another new technique 
used in program line storage concerns numerical constants. If we 


type: ; 


2@LETa=2 


and then: 


FOR i=26721 TO 26735: PRINT i» PEEK is NEXT i. 


we get: 
26721 ® } 28 (line number) 
26722 20 ; = 
26723 11 : 
26724 a } 11 (length of line) 
26725 241 LET token 
26726 97 a 
28727 61 = 
26728 od 2 
26729 14 number token 
26730 Q 
26731 @ 
26732 2 2 
26733 @ 
26734 @ 
26735 13 ENTER 


As you can see from the notations, whenever we have a numerical 
constant in a BASIC line, it is followed by a special token byte (with the 
value 14) and then by five more bytes with the constant's value in 
integer or floating point format. 

There you have it — program storage on the T/S 2068. We can.now 
describe some of the functions performed by the BASIC interpreter. 
We've already seen how the interpreter keeps a variable list and a 
program list in memory. As we, or our program, use new variable 
names, they are added to the variable list. If we enter BASIC program 
lines, they are added to the program list. 

If we type LIST, we know that the interpreter will display the current 
program in memory. It does this by simply going to the start of the 
program list and printing out the text that it finds. Double-byte line 
numbers are converted to their decimal form and printed on the 
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screen. Tokenized keywords are also expanded into their English-like 
form. 

Explaining what happens when you type RUN is a little more compli- 
cated. In fact, it is a Jot more complicated. The basic operation, 
however, is to read each program line in sequence and convert the 
keyword commands into some appropriate action. For this purpose 
these are numerous subroutines stored in ROM that perform each of 
these tasks. Therefore, as a program line is read by the interpreter, it 
looks at the token to decide what subroutine(s) to execute. If further 
data is needed, such as variables or constants, they are read from the 
program line and sent to the subroutine. When a branching instruc- 
tion, such as a GO TO 20, is reached, the interpreter looks down the 
program list for the appropriate line number and then resumes execu- 
tion at that point. That brings us to helpful hint number two. 

When writing long programs, it will speed things up if you place often 
used subroutines at the beginning of your program. Such routines, 
which may be called from various places throughout the program, will 
execute faster since the interpreter will not have to search through the 
entire program list looking for them. Of course, if you really want to 
speed up your programs, then machine language may be the only 
answer. That's the subject of Part Two. First, however, we need to know 
a little bit more about the T/S 2068 hardware. In particular, we shall 

Start with the Z80 CPU which is described in the next chapter. 


SECTION B 
INSIDE THE T/S 2068 


4 | 
The Z80 CPU 


INTRODUCTION 


Our discussion of what's inside the T/S 2068 begins with a detailed 
look at the Z80 CPU. This chapter contains a lot of information which 
may interest only the “hardware hacker” who wants to know the details 
of the Z80’s operation. Much of this material will also be explained in 
later chapters. If you feel that things are getting a little too deep, skip on 
to the next section. The Z80 is a very complicated piece of silicon as 
you can see from the photomicrograph of Fig. 4—1. Fortunately, we 
don’t have to know what's inside a Z80 to be able to program it. But a 
knowledge of its architecture is essential. 


Fig. 4-2 shows a block diagram of the Z80 CPU. The arrows 
indicate how each section is interconnected and how the CPU com- 
municates with the rest of the computer. These arrows indicate how 
the Z80 is organized into several buses. A bus is simply a group of 
wires that are treated collectively. For example, all data flowing into or 
out of the CPU pass along eight wires called the data bus. For this 
reason, the Z80 is referred to as an 8-bit CPU. 


When data is transferred to or from main memory, a 16-bit address 
bus is used to specify which memory location to use. This gives the 
Z80 the capability of directly addressing 64k of memory. (The T/S 
2068 can actually accommodate much more memory as we will see in 
the next chapter.) Within the Z80, data is stored in special memory 
cells called registers. These registers are also connected to the 
Arithmetic and Logic Unit, or ALU, where various operations are 
performed on the data. Finally, there is an instruction decode and CPU 
control section which interprets the machine language program 
instructions and tells the rest of the CPU what to do. 
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Fig. 4—1. Photomicrograph of Z80 CPU. (Courtesy Zilog, Inc.) 


REGISTERS 


The Z80 contains 208 bits of RAM that are available to the program- 
mer. Fig. 4-3 illustrates how this memory is organized into eighteen 8- 
bit registers and four 14-bit registers. The special-purpose registers 
hold information that is closely related to the Z80 hardware and its 
operation. The general-purpose registers are used by the program- 

“mer for temporary storage of data that is to be processed by the CPU. 


Special-Purpose Registers 


Program Counter (PC)—The program counter holds the 16-bit 
address of the current instruction byte being fetched from memory. A 
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8-BIT 
DATA BUS 


INSTRUCTION 
DECODE 
& 
CPU 
CONTROL 


13 
CPU AND 
SYSTEM 
CONTROL 
SIGNALS 


+5V GND @ 


ADDRESS 
CONTROL 
6-BIT 


16-Bl 
ADDRESS BUS 


Fig. 4-2. Block diagram of Z80. (Courtesy MOSTEK Corp.) 


special circuit in the Z80 automatically increments this counter after 
each byte is read. This is what causes the CPU to execute programs 
normally in sequential order. If ajump or call instruction is encountered 
(equivalent to the BASIC GO TO and GO SUB statements), then the 
new address is placed in the PC register. 

Stack Pointer (SP)—The stack pointer holds a 16-bit address 
which points to.a section of system RAM that is reserved for the 
machine stack. The stack is a special type of memory organization 
whereby data can be stored and retrieved on a last-in, first-out (LIFO) 
basis. We'll explain this further in Chapter 10. 

Index Registers (IX and lY)—Each of these two registers can hold 
a 16-bit value. While they can be used as general-purpose storage, 
their primary function is to hold the base address for a special type of 
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MAIN REG SET ALTERNATE SET 


ACCUMULATOR FLAG ACCUMULATOR FLAG 
A F A' F! 
fe ee ee =e 


GENERAL- 
PURPOSE 
REGISTERS 


INTERRUPT MEMORY 
VECTOR REFRESH 
| R 


INDEX REGISTER IX 


SPECIAL- 
INDEX REGISTER IY aeGerens 


STACK POINTER SP 
PROGRAM COUNTER PC 


Fig. 4-3. The Z80 register set. (Courtesy MOSTEK Corp.) 


memory access known as indexed addressing. This will also be 
explained in Chapter 10. 

Interrupt Vector (i) and Memory Refresh (R)}—These are two 8-bit 
registers which support some of the advanced features of the Z80. The 
| register is used with an advanced interrupt handling mode available 
on the Z80. When this mode is selected, the | register supplies the high 
order address for an indirect call to the interrupt service routine. The R 
register is used to refresh dynamic RAMs automatically. 


Accumulator and Flag Registers 


The Z80 has two independent 8-bit accumulators, each with a 
respective 8-bit flag register. These are also referred to as the A and F 
registers, or sometimes treated together as a single 16-bit AF register. 
The programmer can alternate between the two accumulator and flag 
pairs by executing a single exchange instruction. 
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The accumulator is used to hold the results of 8-bit arithmetic and 
logical operations. It is also supported by more instructions and 
addressing modes than any other register. The flag register contains 
six special bits which indicate vital statistics about the value in the 
accumulator and the results of the last operation. These bits can be 
“tested” by other instructions to allow conditional program execution 
based on the results of a previous operation. 


General-Purpose Registers 


There are two matched sets of general-purpose registers in the Z80. 
Each set contains six 8-bit registers that can be used individually or 
treated as 16-bit register pairs. One set is called the BC, DE and HL 
registers, while the other set is called BC’, DE’, and HL’. Just as with 
the duplicate AF registers, the programmer can exchange all three 
register pairs with their “primed” counterparts using a single instruc- 
tion. 


THE FLAG REGISTER 


The notion of a flag register is very important to the design of a CPU. 
Therefore, we should examine the Z80’'s flag registers in a little more 
detail. Although there are actually two separate F registers, only one is 
used at a time. Therefore, we will continue the discussion as if there 
were only one flag register. 

As we have already said, six of the eight bits in the flag register are 
used to denote specific details about the operation of the CPU. The 
remaining two bits are unused. Four of these six bits are testable — 
that is, they can be used as a condition for the execution of certain 
instructions. These are the Carry flag (C), Zero flag (Z), Sign flag (S), 
and Parity/Overflow (P/V) flag. Their bit positions in the Flag register 
are shown next: 


D7 


DO 
(s[z] [HI] J[pvin fc] 


Testable Flag bits: C, P/V, Z. 5S 


The Carry flag is used to indicate that an arithmetic operation has 
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exceeded the 8-bit range available to the accumulator. For example, 
adding the following two numbers would cause a carry to be gener- 
ated: 
19199011 
+ 11981809 


Cc 
1 01101911 

When the carry flag equals 1, it shows that a carry has occurred. The 
carry flag will also be set if a borrow occurs during a subtraction 
operation. Several other instructions, such as the shift and rotate 
group, also affect this bit. 

The Parity/Overflow flag serves a dual purpose, depending upon 
the type of operation being performed by the CPU. When logical 
operations are performed (such as AND A,B), it indicates the parity of 
the result in the accumulator. Parity is derived from the number of “1” 
bits in a given byte and can be either odd or even. After performing an 
arithmetic operation (such as ADD A,B), the P/V flag indicates 
whether there has been an overflow condition. This happens when 
signed numbers are used and result of the operation cannot be 
represented correctly by the 8-bit accumulator. 

The Zero flag is set whenever the results of an operation leave a 
value of zero in the accumulator. It is also used in a slightly different 
fashion by the block I/O and search instructions as well as the BIT 
testing instruction. 

The Sign Flag is a replica of the most significant bit of the 
accumulator. When signed numbers are being manipulated by the 
CPU, the most significant bit represents the sign of the number. A “O” 
indicates that the accumulator holds a positive number, while a “1” 
shows that it is negative. 


Nontestable Flag Bits: H and N 


The other two bits in the flag register are used to implement BCD 
arithmetic. The Half carry (H) flag keeps track of any carry or borrow 
between the lower four bits and the upper four bits of the accumulator. 
The Add/Subtract (N) flag indicates which type of operation was 
performed last. These two bits are used by the DAA (Decimal Adjust 
Accumulator) instruction to properly re-format the contents of the 
accumulator into packed BCD format. This allows the Z80 to perform 


\, The Z80 CPU 83 


Table 4-1. Summary of Flag Operations 
(Courtesy MOSTEK, Corp.) 


joo 
i“ 
Comments 


ADD A,s; ADC As 8 bit add or add with carry 

SUB,s; SBCA,s; CPs; NEG S-bit subtract, subtract with carry, compare and negate accumulator 
AND s 

ORs; XORs 
INCs 


| Logical operations 
8-bit increment 


DECs 8-bit decrement 
AOD DO, SS 16-bit add 
ADC HL, SS 16-bit add with carry 


SBC HL, SS 

RLA; RLCA; RRA; RRCA © 
RLs; RLCs; RRs; RACs; 
SLAs; SRAs;SRLs 


16-bit subtract with carry 
Rotate accumulator 
Rotate and shift locations 


we Oe ee 0 me ee ee 
a ne fe eens 
SS KOE OKO OE KOE OOK 
OSX XK Kae me Oe 
OK OEE OK OK OK OK OKO) 
wecc* cc vVK < 
Core O7-cCoO-o 
a 


Rotate digit left and right 

Decimal adjust accumulator 

Complement accumulator 

Set carry 

Complement carry 

Input register indirect 

Block input and output 

2=Oif B # 0 otherwise Z=1 

Block transfer instructions 

P/V = 1 if BC # 0, otherwise P/V =0 

Block search instructions 
Z=1if A= (HL), otherwise Z = 0 
P/V = 1 if BE # 0, otherwise P/V = 0 

The content of the interrupt enable flip-flop (IFF) is copied into 
the P/V flag 

The state of bit b of location s is copied into the Z flag 


INI; IND; OUTI; QUTD 
INIR; INOR; OTIR; OTDR 
LD; LOO 

LOIR; LODR 

CPi; CPIR; CPD; CPOR 


MK OO Oe 
-x x - Hee Oe 
aK KKK KKK KOK 
—-OOxX XOX OKO 
x > KOK KOK OK OK OK OK OK 
—-O-xXx~ Dee eve 
-eo--ceG~eo 
eoexx eee 


L0A,1;LOA,R 


BIT b,s 


Tha following notation is used in this table: 


SYMBOL OPERATION 


Carry/link fleg, C=1 if the operation produced a carry from the MSB of the operand or result. 

z Zero flag. Z=1 if the result of the operation is zero. 

s Sign flag. S=1 if the MSB of the result is one. : 

P/V Parity or overflow fiag. Parity (P) and overfiow (V) share the seme fiag. Logical operations affoct this flag ~ 
with the parity of the result while arithmetic operations affect this fiag with the overflow of the result. 
If P/V holds parity, P/V=1 if the resuit of the operation is even, P/V=0 if result is odd. If P/V holds over- 
flow, P/V@1 if the result of the operation produced an overflow. 

H Holf-carry fieg. H=1 if the add or subtract operation produced a carry into or borrow from bit 4 of the 
accumulator, 

N Add/Subtract flag. N=1 if the previous operation wes a subtract. 

H and N flags are used in conjunction with the decimal adjust instruction {DAA) to properly correct the 

result into packed SCD format following addition or subtraction using operands with pecked BCD format. 

The flag is affected according to the resuit of the operation. 

The flag is unchanged by the operation. 

The fleg is reset by the operation. 

The flag is set by the operation. 

The flag is a “don’t care”. 

P/V fiag affected according to the overflow result of the operation. 

P/V flag affected according to the parity result of the operation. 

Any one of the CPU registers A, B, C, D, E, H, L. 

Any 8-bit location for ail the addressing modes allowed for the particuler instruction, 

Any 16-bit location for all the addressing modes allowed for that instruction. 

Any one of the two index registers 1X or FY. 

Refresh counter, 

S-bit value in range <0, 255> 

16-bit value in range <0, 65535> 


2° 7 Uexs0c @ 
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BCD arithmetic almost as easily as binary arithmetic. Table 4-1 shows 
a summary of how the flag register is affected by various Z80 instruc- 
tions. The importance of this will become clearer when we begin to 
examine the Z80 instruction set in Chapter 9. 


CPU OPERATION 


All CPU’s operate by repeating a few basic steps over and over. 
These steps are performed according to a-complex interconnection 
between various circuits within the CPU. These circuits operate “syn- 
chronously”; that is, they all perform their functions at a very specific 
time. All of the circuits within a Z80 are timed in accordance with a 
single clock signal. In the T/S 2068, this is a 3.528 MHz square wave 
which is derived from the 14.112 MHz master oscillator inside the 
computer. Each cycle of the CPU clock causes a specific action to take 
place within the Z80. This is also referred to as a T cycle. It takes 
several T cycles to perform a machine cycle. Each machine cycle 
represents the transfer of one byte into or out of the CPU. An instruc- 
tion cycle consists of one or more machine cycles and represents the 
smallest unit available to the machine language programmer. Fig. 4—4 
shows the basic CPU timing for an INC (HL) instruction. This operation 
involves reading the value of a memory location into the CPU, adding 
one to this value, and then storing the new value back into the memory 
location. ; 


T STATE cal eas 


CPU 
MACHINE CYCLE zk M2 2. M3 
M1 (MEMORY READ) (MEMORY WRITE) 


CLOCK 
{OP CODE FETCH) 


INSTRUCTION CYCLE 


Fig. 4—4. CPU timing for executing a typical instruction. (Courtesy 
MOSTEK Corp.) 


The instruction begins with an M1 cycle which is always an op-code 
fetch. During this cycle, the Z80 places the contents of the Program 
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Counter onto the address bus (during T1) and then performs a read of 
this location (during T2). The contents of this location (which is 
assumed to be the op code for a Z80 machine language instruction) is 
then sent to the instruction decoder circuit within the CPU. During the 
next two (or possibly more) T cycles, the CPU “decodesg’ the instruc- 
tion op code. This is really nothing more than setting up certain flags, 
counters, and other circuits within the CPU to prepare it for the 
execution of the instruction. During the instruction decode T cycles, 
the Z80 places the contents of its internal Refresh counter onto the 
address bus and a “dummy” memory read is performed. No data is 
transferred during the read; its sole purpose is to allow for the refresh 
of dynamic RAMs. Since the refresh counter is incremented after 
every instruction, it will take 128 instructions to completely cycle 
through the entire 7-bit refresh counter values. At this point, however, 
every byte of dynamic RAM will have been refreshed. If the particular 
op-code read is for an instruction that requires more information (such 
as another op-code byte or an immediate. mode operand) then 
another memory read will take place. This is accomplished by again 
putting out the PC address (which has automatically been incre- 
mented) and retrieving the next byte. 

In the case of the INC (HL) instruction, the instruction decoder has 
informed the address control circuit that the contents of the H and L 
registers should next be placed onto the address bus (M2, T1 cycle). 
During the next T cycle, the contents of the memory location are read 
into the ALU. The instruction decoder has already set up the ALU to 
perform the ‘ADD 1” function. After the result is obtained, it is written 
into memory during the next machine cycle. 


SPECIAL FUNCTIONS 


There are four special functions that the Z80 can perform in 
response to hardware signals. These are the RESET, WAIT, INT, and 
NMI. Each of these functions is initiated when their corresponding pin 
on the Z80 chip is brought low. 


RESET 


A RESET signal causes the CPU to become initialized. This allows 
the system to begin operating from a well defined state. On the T/S 
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2068, the CPU is reset every time the computer is turned on. Initializa- 
tion of the Z80 includes: 


1. Loading the Program Counter with a value of 0000. 
2. Disabling interrupts. : 

3. Loading the I and R registers with a value of 00. 

4. Setting Interrupt Mode 0. 


WAIT 


When the WAIT line on the Z80 is brought low, the CPU will tem- 
porarily halt execution of its program. It will enter a “wait state” until this 
line is brought high again. The main purpose for this function is to allow 
the Z80 to communicate with devices that cannot read or write data as 
fast as the CPU. For example, when the CPU wants to read from RAM, 
it sets up the correct location on the address bus and then reads the 
data bus a short time later. It assumes that the memory device being 
read is fast enough to present its data within the specified amount of 
time after being addressed. If this is not the case, then the memory 
device can pull the WAIT line down for one or more clock cycles until its 
data is ready to be read by the CPU. 


INT (Interrupt Request) 


The Interrupt Request line is used to trigger an interrupt to the CPU. 
There are three different ways in which the Z80 can respond to such a 
signal. In the T/S 2068, an INT interrupt will cause the CPU to suspend 
its current operation and begin executing the program starting at 
location 38h. It is possible to enable and disable this function from 
software. 


NMI (Nonmaskable Interrupt) 


Like the INT interrupt, this signal will cause the CPU to stop execut- 
ing its current program temporarily and begin running an interrupt 
service routine. For an NMI, the CPU performs a call to location 66h. 
This interrupt cannot be disabled from software. 
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ADDRESSING MODES 


Most of the Z80 instructions operate on data stored in internal CPU 
registers, external memory, or in the I/O ports. Addressing refers to 
how the location of this data is generated in each instruction. There are 
ten different addressing modes possible with the Z80, although not 
every mode is available with each instruction. Here is a brief summary 
of each addressing mode. : 


Immediate Addressing 


In this mode of addressing, the byte following the op code contains 


the actual operand. 
1 or 2 bytes 


d7 dg 


An example of this type of instruction would be to load the accumulator 
with a constant where the constant is the byte immediately following 
the op code. 


Immediate Extended Addressing 


This mode is merely an extension of the immediate addressing 
mode in that the next two bytes following the op code are used as the 
operand. 


1 or 2 bytes 
low-order byte 


high-order byte 


An example of this type of instruction would be to load the 16-bit HL 
register pair with two bytes of data. 


Modified Zero Page Addressing 


This mode applies to the special single-byte call instructions known 
as restarts. These instructions set the Program Counter to one of eight 
specific locations in page zero of memory. The benefit of this address- 
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ing mode is that it allows a single byte instruction to specify a complete 
16-bit address. This saves memory space and shortens execution 
time. 


Relative Addressing 


When a program needs to execute instructions in a nonsequential 
order, the jump instruction is used. If the new address where the 
program is to continue executing is fairly close (less than 127 bytes 
away), then this location can be specified by a one byte offset from the 
program's current location. Using relative addressing, the byte follow- 
ing the op code is treated as a signed, twos-complement integer which 
is added to the address of the op code of the next instruction. 


op code | Jump relative 
8-bit twos-complement displacement 
There are two major advantages of using relative addressing. First, 
it allows the 16-bit jump address to be specified by a single byte for 
reduced memory usage and faster operation. Second, the use of 
~ relative addressing allows for relocatable code. This means that a 


program can be moved to any absolute location and still operate 
correctly. 


Extended Addressing 


Extended addressing means that the two bytes representing the 
address are included within the instruction. 


1 or 2 bytes 
low-order address 
high-order address 


With extended addressing, a jump instruction can reach locations 
which are more than 127 bytes away. 


Indexed Addressing 
In this type of addressing, the byte following the op code contains a 
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displacement which is added to one of the index registers (the op code 
specifies either IX or IY) to form the address of amemory location. The 
contents of the index register is not altered by this operation. 


op code 


Displacement 


2-byte op code 


8-bit twos-complement displacement 
added to index register to form 
memory address 


Indexed addressing greatly simplifies programs that use tables, 
since the index register can point to the start of the table and the 
displacement can specify a given element within the table. Indexed 
addressing also facilitates the generation of relocatable code. 


Register Addressing 


Many of the Z80 op codes contain special bits which specify one of 
the CPU registers as the operand. This is known as register address- 
ing. For example, we could have an instruction that would load the 
contents of register B into register C. 


Implied Addressing 


Implied addressing refers to operations where the op code automat- 
ically implies one or more of the CPU registers to be used as an 
operand. Instructions involving the | and R registers are examples of 
implied addressing. 


Register Indirect Addressing 


Register Indirect Addressing allows one of the 16-bit register pairs in 
the CPU to be used as a pointer to any location in memory. Since the 
address for the operand must already be loaded into the selected 
register pair, the instruction takes the form of a simple one- or two-byte 
op code. 

An example of this iype of instruction would be to load the 
accumulator with the contents of the memory location pointed to by 
the HL register. Such an instruction would be written in assembly 
language mnemonics as LD A, (HL). The use of parentheses around 
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the HL operand signifies that this register is to be used as a pointer toa 
memory location. That is, when-we.write HL, it means we are inter- 
ested in the contents of the register pair HL. But (HL) means that we 
want the contents of the memory location pointed to by the HL register. 

Register Indirect Addressing can also be used to specify 16-bit 
operands. In this case, the contents of the register point to the first 
(lower) byte of the 16-bit operand. The register contents are then 
automatically incremented to obtain the address of the high order 


byte. 


Bit Addressing 


The Z80 has the ability to set, reset, or test any bit within a CPU 
register or memory location. Only the specified bit is affected (or 
examined). The actual location tested can be specified by either 
register, register indirect, -or indexed addressing and the specific bit is 
indicated by three bits of the op code. 


+) | 
Memory Map of the 
T/S 2068 


Since the Z80 has 16 address lines, it can address up to 65,535 
different locations. Only six or seven years ago, 64K of memory was 
considered enormous. It represented the upper limit for personal 
computers. Today's programs have just begun to stretch this limit. The 
IBM PC uses a 16-Bit CPU capable of addressing megabytes of RAM. 
Eight-bit machines, such as the T/S 2068, however, must turn to a 
design called “bank switching” to increase accessible memory. Bank 
switching allows more than 64K of memory to be connected to a single 
8-bit CPU. For this to work, two or more memory devices must be 
assigned the same physical memory address. The trick, therefore, is 
in keeping one, and only one, device active at any given time. This is 
the job of the T/S 2068's memory bank switching hardware. 

While switching complete banks of 64K memory addresses is 
sometimes useful, in the T/S 2068 it proves more desirable to break 
each bank into several “chunks.” Making each chunk 8K bytes long, 
divides the Z80 address range into 8 equal parts. These are labelled 
chunk 0 through chunk 7. Since the T/S 2068 is capable of controlling 
256 different banks of memory, a memory map of the computer would 
look like Fig. 51. The banks are numbered from 0 to 255. Of course, 
more of these banks will be empty (i.e., they will not contain any RAM 
or ROM) so it would not be of much use to turn them on. 


BANK SELECTION 


There will always be eight and only eight chunks active at any point 
in time. Each chunk will have a different number and can reside in any 
of the 256 banks. Three of these banks are reserved for special 
purposes; the remaining 253 are called expansion banks and may be 
used by peripherals that connect to the back of the T/S 2068. 
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MEMORY MEMORY MEMORY MEMORY 
BANK 0 BANK 1 BANK 2 BANK 255 


CHUNK 4 
CHUNK 3 
CHUNK 2 
CHUNK 1 


CHUNK 0 


Fig. 5—1. Memory map of T/S 2068. 


Home Bank 


Bank number 255 is called the Home Bank. It contains most of the 
T/S 2068's built-in ROM and all of its RAM. It is the bank that gets 
selected by default and thus occupies the entire 64K space when the 
computer is first turned on. The Home ROM contains the BASIC 
interpreter, the fundamental I/O routines (display, keyboard, printer, 
etc.), and basic links to other peripheral devices through a channelled 
/O section. To enable any chunks in the other banks, a special 
sequence of instructions must be executed by the CPU. We'll explain 
this technique shortly. 


EXROM Bank 


Bank number 254 is called the Extension ROM, or EXROM, bank. It 
contains only one ROM which occupies chunk #0. When selected, it 
replaces the first chunk of ROM in the Home Bank. Contained within 
the EXROM are the cassette tape I/O routines, bank switching code, 
and system initialization procedures. Initialization of the T/S 2068 can 
be quite complex and most of the machine code to do this resides in 
the EXROM. Of course, when the computer is first turned on, it is the 
program in the Home ROM that starts executing. Therefore one of the 
first things that the Home ROM does is to enable the EXROM and then 
jump to its initialization routine. 


Memory Map of the T/S 2068 93 


Dock Bank 


Bank number 0 is called the Dock bank. It represents any memory 
contained within a Timex Command Cartridge. These cartridges are 
inserted into the compartment on the right side of the T/S 2068 which 
attaches them to the computer's dock connector. The Dock bank is 
usually occupied with some form of ROM Oriented Software. 


Expansion Banks 


The remaining 253 banks are available for use by peripherals that 
connect to the T/S 2068's rear card edge. To be compatible with the 
bank switching scheme employed by the T/S 2068, such peripherals 
must follow the hardware and software protocol set by Timex Com- 
puter. This will be described next. 


BANK SWITCHING HARDWARE/SOFTWARE 


All of this talk about bank switching sounds great but there are some 
restrictions. First of all, we need some sort of hardware to physically 
enable and disable each bank that we have. This hardware is built into 
the T/S 2068 for controlling the Home, EXROM, and Dock banks. A 
very elaborate bank switching-control scheme is also implemented in 
the T/S 2068 for handling the Expansion Banks. 

Another problem associated with bank switched memory is that 
when the switch takes place, it must not affect the program flow of the 
routine that does the bank switching. That is, you would not want the 
CPU executing a program in one bank, and then suddenly find itself in 
the middle of some other routine in another bank. There are two ways 
around this problem. One way involves duplicating the bank switching 
code into the same memory locations of each bank that is to be 
switched. Therefore, as the bank switching routine executes and 
performs the switch, the CPU continues to execute the same program 
(although it is now in another bank). 

The other way to solve this problem is to have one section of 
memory which is never switched out. This area can then contain the 
bank switching code as well as any other common information (such 
as interrupt handlers, machine stack, etc.). In the T/S 2068, memory 
chunk 3 is normally reserved for such use. 
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Bank Switching Control 


The bank switching hardware within the T/S 2068 is accessed 
through four I/O ports: 


DKHSPT = F4h Dock horizontal select port * 

BDATPT = FCh Expansion bank data port 

BCMDPT = FDh Expansion bank address port 
HREXPT = FFh Home ROM extension select port (bit7) 


The Home Bank has the lowest priority, thus its chunks are enabled 
by default when no other Bank has the same chunks enabled. The 
DOCK Bank has the next highest priority, thus its chunks are enabled 
when no Expansion Bank has the same chunks enabled. The Expan- 
sion Banks have the highest priority. The Home ROM Extension Bank 
(EXROM) has the same priority as the DOCK Bank. 

The Dock horizontal select port controls which of the DOCK bank 
chunks are to be enabled. By sending a given value out through this 
port, those chunk numbers corresponding to the 1’ bits in this value 
will be enabled. Thus to activate only chunk number 7 in the DOCK 
Bank, we would OUTput the binary number 10000000 through port 
F4h. It is also possible to INput from this port and read back the current 
status (i.e., which DOCK chunks are enabled). 

The EXROM is selected by writing a ’1’ to bit 7 of the HREXPT port 
(FFh). If this bit is set, the EXROM will overlay chunk 0 of the DOCK 
Bank. Thus to access this ROM, you must set bit 7 in port FFh and set 
at least bit 0 in the DKHSPT port (F4h). You must also insure that no 
external Banks have done their chunk 0 selected, since external 
Banks have higher priority than the DOCK Bank and, also, therefore 
the EXROM Bank. 


HOLD Temporary hoiding register 

ABN Assigned bank number (one for each expansion bank) 

BNA Bank number accessed register 

HS Expansion bank horizontal select register (one for each expan- 
sion bank) 

STATUS Status nybble* whose bits have the following interpretation: 


bit 0—Set to 8 if bank caused an 
IRQ interrupt 

bit 1—Not used 

bit 2—Set to 9 if bank is responding 
to memory read/write 

bit 3—Not used 


*A nybble equais half of a byte or 4 bits. 
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Selecting an Expansion Bank is a little more complicated because 
we must use the HOLD register to latch data into and out of the BNA, 
ABN, and HS registers. The BNA register contains the number of the 
Bank whose status is being read or changed. The ABN register 
contains the Bank number assigned to a particular Bank. And the HS 
register specifies which chunks in that expansion Bank are enabled. 
Note that there is only one HOLD register and one BNA register. There 
are ABN and HS registers for each Expansion Bank, however. 

There is no way to directly read or write to these registers from the 
Z80. The only way to access these registers is through the Expansion 
Bank Controller Registers shown in Table 5—1. These, in turn, are 


Table 5-1. Expansion Bank Controller Registers 
(Courtesy Timex Computer Corp.) 


Read status Write command Type I 
None Write command Type II 
Read HS |s nybble Write hold reg. ls nybble 
Read HS ms nybble Write hold reg. ms nybble 


reached via the BDATPT (FCh) and BCMDPT (FDh) ports. The 
BCMDPT port is first used to address one of the Expansion Bank 
Controller Registers by sending out a 2-bit value. This selects one of 
the four controller registers which can then be read or written-to by the 
BDATPT port. By writing to controller registers O-or 1, we can perform 
one of the eight commands as listed in Table 5-2. 

If all this seems rather complicated, it's because it really is! An 
example will make things clearer. Suppose we have a device plugged 
onto the back of our T/S 2068 and it has some ROM which we would 
like to activate into chunk 0. We'll assume it is configured as bank 
number 1. We thus need to enable chunk 0 in Bank 1. Since Expansion 
Banks have the highest priority, we do not have to worry about turning 
off the Home ROM chunk 0, DOCK Bank chunk 0, or the EXROM. We 
would first, however, have to disable any other Expansion Banks that 
had chunk 0 active. Now we must load a binary 00000001 into the 
Horizontal Select (HS) register for bank number 1. To do this, we start 
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Table 5-2. Expansion Bank Controller Commands 
(Courtesy Timex Computer Corp.) 


Function 

Reset controller — prepare to initialize. 
Start interrupt REG sequence. 
Initialization done. Move to next bank in 
daisy chain. 

‘Reset interrupt flag. 


Type IT Commands 


Function 

Dump HOLD register to ABN. 
Dump HOLD register to BNA. 
Dump HOLD register to HS. 
Not used. 


by setting the Bank Number Access Register to 1. This is accom- 
plished by writing 01 into the HOLD register (it takes two steps) and 
then causing the “Dump HOLD register to BNA” command to be 
executed. In machine language, this would look like: 


OUT FD+2 Select control register 2 

QUT FC+1i Write lower half of bank number into HOLD register 

OUT FD:+3 Select control register 3 

QUT FC+0 Write upper half of bank number 

OUT FD:;1i Select control register 1 

OUT FC +13 Send Type li command number.1 (Dump HOLD register to BNA) 


Now that we have set the BNA register to point to the desired bank, 
we must set the corresponding HS register. In this example, our HS 
value is the same as the BNA value so the HOLD register is already 
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loaded with the proper value. Thus to complete our task, we only need 
to perform: 


OUT FC+1i Send Type ll command number 2 (Dump HOLD register to HS) 


With that, we have accomplished our goal. All of this assumes, 
however, that we have previously initialized the bank controller and 
that our Expansion Bank had been assigned a bank number of. 1. Also 
note that it is possible to read a status byte associated with the bank. 
This byte is used to indicate whether the bank contains any RAM and 
also to indicate if the bank has generated an interrupt signal to the 
CPU. 


HOME BANK MEMORY MAP 


Fig. 5-2 shows the layout of the Home Bank on the T/S 2068. The 
labels along the outside. of the map refer to system variables as 
described on pages: 261-265 of the 7/S 2068 User Manual. Some of 
these change as the computer is used; their initial values are shown in 
parentheses. When two display files are in-use (e.g., in the 64-column 
mode), the machine stack and RAM-resident code are moved up to the 
top of RAM. The second display file then takes their place starting at 
location 6000h. 


INPUT/OUTPUT FACILITIES 


Nineteen of the Z80 ports have been assigned by the T/S 2068 as 
outlined in Table 5—3. Port FEh is used by a number of devices in the 
T/S 2068. When reading port FEh, the five least significant bits (DO- 
D4) represent the outputs from the keyboard and D6 corresponds to 
the Cassette Tape Input signal. By writing to Port FEh, we can set the 
border color (in DO, D1, and D2), set the tape output signal (D3), or 
toggle the internal speaker (D4). 

Port FFh also controls a number of circuits within the T/S 2068 as 
follows: 
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Bit 0 — Enables D FILE_2 (secondary display file) 

Bit 1 | — Enables ultra-high-color resolution mode 

Bit 2 | — Enables 64-column display (requires bit @ to be set) 
Bit3 

Bit 4 } — Set paper color for 64-column display 

Bits i 

Bit 6 §— Disables keyboard interrupts 

Bit 7 | — Enables extension ROM in the EXROM bank 


Table 5-3. T/S 2068 I/O Port Assignments 
(Courtesy Timex Computer Corp.) 


Display Modes, Extension ROM, Interrupt 
Control 
Keyboard, Border Color, Tape, Beep 
Bank Controller — Address 
Bank Controller — Data 
Printer 
Printer 
Printer 
| Printer 
Reserved 
PSG — Data 
PSG — Address 
DOCK Horizontal Select 
Printer 
Printer 
Printer 
Printer 
Reserved 


Notes: Modem uses ports C7, CF, D7, DF. 
Timex devices will use ports 78-FFh. 
Other vendors will use ports 00-77h. 


KEYBOARD 


The keyboard on the T/S 2068 is divided into a matrix of eight “half 
rows’ with five keys each. When a key is pressed, it makes a connec- 
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NAME 
P-RAMT 


UDG 
RAMTOP 


STKEND 
STKBOT 


WORKSP 
E-LINE 


VARS 


PROG 
CHANS 


HOME BANK MEMORY MAP 


USER DEFINED, GRAPHICS 


DECIMAL 
65,535 


65,368 
65,367 


(26,726) 
(26,726) 


(26,712) 


(26,711) 


(26,710) 


26,710 
26,688 


25,207 
25,088 
24,576 
23,552 


23,296 
22,528 


16,384 


0 


HEX 
FFFF 


FF58 
FF57 


(6866) 
(6866) 


(6858) 


(6857) 


(6856) 


6856 
6840 


6277 
6180 
6000 
5C00 


5B00 
5800 


4000 


0000 


CALCULATOR STACK 
TEMPORARY WORK SPACE 


INPUT DATA 


=80n— 
—ENTER— 
EDIT BUFFER 


~80h— 
VARIABLES 


—80h— 
BASIC PROGRAM 


CHANNEL INFORMATION 


BANK SWITCHING CODE 


FUNCTION DISPATCHER 
STACK 


SYSTEM VARIABLES 
PRINTER BUFFER 


ATTRIBUTE 
AND 
DISPLAY-FILE 1 


99 


Fig. 5-2. Home Bank memory map (Numbers in parenthesis repre- 
sent initial values for system variables — these will change 
as computer is used.) 
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tion between its “row line” and “column line.” To detect when a key has 
been pressed, the computer repetitively scans through all eight rows, 
looking for a signal that represents a keypress. On the T/S 2068, this is 
accomplished by connecting the eight row lines to the upper half of the 
address bus. The five column lines connect to the CPU through I/O 
port FEh. 

By sequentially lowering each of the address lines A8—A15 and then 
reading the I/O port, the CPU can tell what key, if any, has been 
pressed. Normally, with no keys pressed, the five keyboard bits read 
through the port will all be high no matter what address is used. When 
a key is pressed, however, it will place a low on its respective I/O bit 
whenever its row address line is also low. Therefore, by detecting the 
column bit and knowing the row position, the keyboard polling routine 
can determine which key was pressed. Table 5-4 describes how each 
key is mapped. DO represents the key closest to the outside of each 
row; D4 the one nearest the middle of the keyboard. A bit is 0, if key is 
pressed; 1 if it is not. 


SOUND 


There are two ways to generate sound on the T/S 2068. By toggling 
bit 4 of port FEh, many types of sounds can be generated under 
software control. This usually must be done in machine language and 
it may require all of the CPU's time just to generate the sound. To see 
how this works, type in the following one-line program: 


10 OUT 254,57: OUT 254,23: GOTO10 


When this is RUN, the computer will generate a low pitched tone. 
Notice that this is about the fastest BASIC program that can toggle the 
port as required. Therefore, this program creates the highest pitched 
tone possible from BASIC. Of course, you can add other statements to 
slow this program down if you want lower pitched notes. With machine 
language, however, we can create tones that are so high in frequency 
that they cannot even be heard. 

In case you haven't figured out what this BASIC program does, here 
is a quick rundown. The OUT command is used to send data to the 
port number 254 (FEh). The first statement puts out a value of seven. 
This sets the speaker toggle (bit 4) to a zero and leaves the border 
color white (by setting bits 0, 1, and 2 high). The next statement comes 
along and outputs a value of 23. This sets the speaker bit high while 
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Table 5-4. Hardware Map of T/S 2068 Keyboard 


= Indicated When Bit Is Low 
ee mao 


Port Address 


Decimal Hex 


B SYMBL |SPACE* 
H i L 

Y U oO 

6 7 i) 

SS) 4 2 

T R Ww 

G F S 

V Cc Z 


“Same as BREAK key. 


keeping the border color bits the same. Thus the speaker will toggle 
one time, putting out a small click. When the final statement is 
executed, the program returns to the beginning of the line and starts 
over. While the BASIC interpreter is relatively slow for this type of task, 
it is still able to execute this line about 200 times per second, creating 
the low-pitched tone. 

The T/S 2068 also contains a Programmable Sound Generator chip 
which is tied to the CPU through ports F5h and F6h. The first port is 
used to address one of the 15 registers in the PSG. The other port is 
then used to read or write data to these registers. See Chapter 7 for 
more details on the PSG. The sounds generated by these two meth- 
ods are combined to drive the speaker underneath the T/S 2068. The 
software generated sounds also feed the cassette MIC jack. There- 
fore, these sounds can be recorded on the cassette machine or fed 
into an amplifier, if desired. The sounds generated by the PSG do not 
~ come out this jack but there is a signal available on the rear card edge 
connector. 


JOYSTICKS 


The two joystick connectors are read through the I/O port on the 
PSG. To access this port, a value of 14 must be written to the PSG 
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address port (F5h). Bit 8 of the address bus is used to select one of the 
two joystick connectors. The CPU can then determine the status of the 
selected joystick by reading the PSG data port (F6h). The byte read is 
interpreted as follows: 


z 


Bit 0 — 0 indicates stick is UP 

Bit 1 — 0 indicates stick is DOWN 
Bit 2 — 0 indicates stick is LEFT 
Bit 3 — 0 indicates stick is RIGHT 
Bit 4 ‘i 

Bit 5 |. — Not used (all ones) 

Bit 6 


Bit 7 —0O indicates button is depressed 


6 
Connecting to the Outside 
World 


lf “No man is an island,” then no computer is a complete data 
processing system. To do anything useful, we need to attach a variety 
of peripherals such as a television or monitor, tape recorder, printer, 
modem, etc. All of these devices connect to the T/S 2068 through a 
variety of special connectors. 

By-now, you are probably familiar with the POWER, TV, MONITOR, 
EAR, and MIC connectors. The power-supply unit that plugs into the 
wall supplies electricity to operate the T/S 2068 through the POWER 
connector. To create a visual display on your television set or video 
monitor, the computer generates a special electronic waveform called 
a composite video signal. (It is also possible to connect a monitor 
directly to the computer's RGB signals — this will be discussed in the 
next chapter.) There are three places on the back of the T/S 2068 
where this composite video signal is available. The first place is at the 
MONITOR jack which is the normal place to connect a video monitor. 
This same signal is also available on one of the pins of the peripheral 
expansion connector. The-video signal also goes to an RF modulator 
within the T/S 2068 where it is converted into a radio frequency signal 
much like the one broadcast from your local tv station. This allows the 
computer to be conveniently connected to the antenna terminal of a tv 
set, usually through a transfer switch box. The computer's video signal 
is then seen by tuning the tv to the proper channel. 

For program and data storage, most T/S 2068 owners use a simple 
cassette recorder. The computer contains all of the hardware and 
software needed to support such a mass storage device. Two connec- 
tors are used to hook up a recorder. The MIC jack sends out a very 
small signal (on the order of the level produced by a microphone — 
about 150 mV). The signal can then be fed into the MIC jack of the 
recorder and used to store data from the computer on tape. See 
Chapter 15 for details on this signal. When the tape is played back, the 
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signal from the recorder’s EAR phone output is then fed into the EAR 
jack on the T/S 2068. The computer can “listen” to this signal and then 
reconstruct the data that originally was in the machine when the tape 
was SAVE’d. 

The output level from a cassette recorder can vary according to the 
setting of its volume control. For proper operation, the T/S 2068 
requires a signal level of several volts. By the way, any software 
generated sounds such as the “keyclick” or BEEP commands, also 
come out the MIC jack. 


JOYSTICK CONNECTORS 


There are two joystick connectors on the T/S 2068 — one on each 
side of the machine. These connectors are designed to accept stan- 
dard eight-position joysticks with 9-pin “D” type plugs. These are 
compatible with joysticks used on the Atari and Commodore comput- 
ers, as well as most video games. Fig. 6—1 and Table 6-1 show the pin 
assignments for these connectors. 


Oz 
Os 


Os O14 Os 
O7 O8 Os 


veya 


Fig. 6-1. Joystick connectors. 


When the “stick” is moved away from its center position, it will close 
one (or two) switches within the joystick. These switches will then 
connect the Read Strobe line to the corresponding direction output 
pin. When the joystick port is being accessed, the Read Strobe signal 
will go low. Thus, any direction pins whose switch is closed will also go 
low. The other direction outputs will remain high. By reading the port 
data, the computer can determine which, if any, joystick switches are 
closed. 

If you are not going to use joysticks, these connectors can be used 
for other general-purpose I/O. The direction pins, for example, can be 
connected to any “TTL-compatible” circuit. This would give up to ten 
input lines that could be used to check the status of various external 
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Table 6-1. Joystick Connector Pin Assignments 


| Pin | Name Description 


Direction One (UP) 
(DOWN) 
Direction Three (LEFT) 
(RIGHT) 


Direction Two 


Direction Four 


Not used 


Button Input 
Not used 


on Dm oO fF © HP = 


Read Strobe. This pin goes low for approx. 
3S when the joystick port is being read. It 
is an open-collector output. 


Not used 


devices. By using the STICK command, these inputs can easily be 
read by a BASIC program. The Read Strobe output signal can also be 
used to trigger an external device. This pin goes low when active, but 
requires a pull-up resistor to make it go high when inactive. Adding a 
10K-ohm resistor between Read Strobe and +5 Volts should work just 
fine. Since the +5-volt line is not available at this connector, an 


alternative is just to tie the RDSTB signal to one of the direction input 
lines. This will give it the necessary pull up (via a resistor on the 
direction input line) but. makes that direction input unusable. Note that 
the RDSTB signal is a single, very narrow pulse. It stays low for only 

- about 3 microseconds (that's 3 millionth’s of a second!) and then goes 
high again. You can also generate a RDSTB signal from BASIC using 
the STICK command. 


DOCK CONNECTOR 


Inside the Timex Command Cartridge slot there is a 36-pin edge 
connector. This allows any ROM Oriented Software cartridges placed 
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A14 1 2 +5V 
A12 3 4 A13 
DO OS 6 D7 : 
Di 7 8 AO 
D2 9 10 At 
p61 12 AB 
D5 13 14 AB 
D315 16 A15 
D4 17 18 MREQ 
iORQ = 19 20 A7R 
RD 21 22 «M1 
WR 23 24 «AB 
AZ 25 26 «AG 
AG 27 28 ~=A10 
A5 29 30 All 
A438 32 RFSH 
BE 33 34 EXROM 
ROSCS 35 36 GND 
BOTTOM SIDE TOP SIDE 


Fig. 6-2. DOCK connector. 


in this connector to interface with the computer. Fig. 6-2 and Table 6—2 
show the layout and function of each pin on this connector. Since the 
DOCK port is used primarily to support ROM software, the signals 
available at this connector are related to the data bus, address bus, 
and bank switching hardware. 


PERIPHERAL EXPANSION CONNECTOR 


On the back of the T/S 2068 behind a small cover, there is a 64-pin 
card edge for peripheral expansion. This is where the T/S 2040 printer 
and T/S 2050 modem are attached. The layout of this card edge is 
shown in Fig. 6-3 and a description of each signal is given in Table 
6-3. 


DZIN 1 
MICIBEEP 2 
+15V 3 
+5V 4 
NOTUSED 5 
SLOT 6 
GND 7 
GND 8 
0 9 
AO 10 
At 11 
A2 12 
A3 13 
AIS 14 
A14 15 
A13 16 
Al2 17 
All 18 
a A10 19 
: AQ 20 
Ag 21 
A722 
AB 23 
A524 
AS 25 
NOT USED 26 
R27 
G 28 
B 29 
GND 30 
VIDEO 31 
GND 32 
"A" SIDE 
TOP 
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4 DZOUT 
2 EAR 
3 ATR 
4 D7 
5 NOTUSED 
6 SLOT 
7 DO 
8 D1 
9 p2 
10 D6- 
11 -DS 
12 D3 
13 «D4 3 
14. «INT a 
15 NMI E 
16 HALT $ 
17 MRE 8 
18 iORG 8 
ag. BD Q 
20 R F 
21. BUSAK 
22 ~=WAIT 
23 +=BUSRQ 
24 RESET 
25 Mi 
26 RFSH 
27. +EXROM 
28  ROSCS 
29 +2-BE 
30 GND 
31 SOUND 
32 GND 
"B” SIDE 
BOTTOM 


Fig. 6-3. Expansion edge connector. 


Most of the data and address lines are not internally buffered by the 
T/S 2068 and, therefore, must be used with care by any peripherals. If 
these lines must be connected to several other devices, they should 
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first be buffered by a suitable circuit. Just about every useful signal 
within the T/S 2068 is available at the expansion connector, including 
all of those at the DOCK connector. A portion of the 64-pin expansion 
card edge is compatible with the 46-pin card edge used by the T/S 
1000 computer. Those pins which are identical are shown in Fig. 6-3. 
This compatibility makes it possible to use some peripherals (such as 
the T/S 2040 printer) with either computer. In general, however, 
devices designed for the T/S 1000, T/S 1500, or the Sinclair Spectrum 
will not work with the T/S 2068 computer. 


Table 6-2. DOCK Connector Pin Assignments 


Description 


have been buffered on the T/S 2068. 


+5-volt power supply. 
The 8-bit bidirectional data bus. 


Memory Request. This line goes low when 
the Z80 is ready to access a memory 
location. 


1/O Request. This line goes low when the 
Z80 is ready to access an I/O port. 


Refresh address bit 7. 


Read. This signal goes low when the Z80 
wants to read data from a memory location 
or I/O device. 


CPU MI state. This signal indicates when 
the Z80 is performing an M1 (instruction 
fetch) cycle. 
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Table 6-2 — cont. DOCK Connector Pin Assignments 


23 WR 


Write. This signal goes low when the Z80 
wants to write to a memory location or I/O 
device. 


Refresh. This line signals when the Z80 is 
putting out a refresh address on the lower 
half of the address bus. 


Bank Enable. When this line is pulled low, 
it disables the RAM/ROM inside the T/S 
2068. This allows the cartridge memory to 
be accessed conflicting with the internal 
memory. 


Extension ROM enable. This signal is used 
to access the EXROM. 


Rom Oriented Software Chip Select. When 
this signal goes low it indicates that the 
CPU wishes to access the RAM or ROM on 
the ROS cartridge. 


System electrical ground. 


Table 6-3. Expansion Edge Connector Pin 
Assignments 


control the selection of the Expansion 
memory banks. 


This line is a duplicate of the signal at the 
EAR jack on the rear of the computer. It can 
be used as either an input or output. 
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Table 63 — cont. Expansion Edge Connector Pin 
Assignments 


Ce a 


Refresh address bit 7. 
4A, DO-D7 ‘(| This is the 8-bit bidirectional data bus. 


5A — Not used. 
6A —_— Slot. 
14A INT Interrupt Request. When this line is pulled 


low, the T/S 2086 begins an interrupt cycle 
if the interrupt flag (IFF) has been set. 
Otherwise, this line is ignored. 


15A NMI Nonmaskable Interrupt. When this line is 
pulled low, the T/S 2068 will begin 
executing an NMI cycle. This causes the 
Z80 to perform a restart to location 0066h. 


16A HALT This signal indicates that the Z80 has 
executed a HALT instruction and is 
awaiting either an INT or NMI interrupt 
before operation can resume. 


17A MREQ_ |Memory Request. This line goes low when 
the Z80 is ready to access a memory 
location. 


18A IORQ V/O Request. This line goes low when the 
Z80 is ready to access an I/O port. 


19h |RD Read. This signal goes low when the Z80 
wants to read data from a memory location 
or I/O device. 


20A WR Write. This signal goes low when the Z80 
wants to write to a memory location or I/O 
device. 
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Table 6-3 — cont. Expansion Edge Connector Pin 


Assignments 


a el 


2B 


3B 


4B 
| 5B 
6B 


7B,8B, 
30B,32B 


9B 
10-25B 
26B 
27B 
28B 

| 29B 
31B 


21A 


BUSAK 


Daisy in. This signal is used with the Dais 
out line to coordinate access of the 
Expansion memory banks. 


This line carries the same signal as the 
MIC jack but at a higher level. It contains 
pulses generated by the cassette write and 
software BEEP routines. 


+15 volt unregulated. Actually this can be 
as high as +2] volts. 


+5-volt regulated power supply. 
Not used. 
Slot. 


System electrical ground. 


CPU system clock (inverted). 

This is the 16-bit:address bus. 

Not used. 

Red color signal. (TTL level — positive). 
Green color signal. (TTL level — positive). 
Blue color signal. (TTL level — positive). 


Composite video signal. This is a 
duplicate of the signal.available at the 
MONITOR connector. Approximately 1V 
peak-to-peak. 


Bus Acknowledge. This line is used to 
indicate that the CPU address, data, and 
control signals have been deactivated so 
that an external device can now control 
these signals. 
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Table 6-3 — cont. Expansion Edge Connector Pin 
Assignments 


Pulling this line low will cause ‘the CPU to 
enter wait states for as long as the line is 
held low. 


Bus Request. This line is used to signal the 
Z80 that an external device wishes to take 
control of the data and address buses. 


Pulling this line low causes the computer 
to perform a reset operation as if it were 
just turned on. This line can also be used 
as an output to reset external hardware 
whenever the computer is reset. 


CPU M1 state. This signal indicates when 
the Z80 is performing an M1 (instruction 
fetch) cycle. 


Refresh. This line signals when the Z80 is 
putting out a refresh address on the lower 
half of the address bus. 


Extension ROM enable. This signal is used 
to access the EXROM. 


Rom Oriented Software Chip Select. When 

this signal goes low it indicates that the 

CPU is accessing the RAM or ROM on a 
cartridge in the DOCK connector. 


Bank Enable. When this line is pulled low, 
it disables the RAM/ROM inside the T/S 
2068. This allows the Z80 to communicate 
with an External memory bank without 
conflicting with the internal memory. 


30A,32A| GND System electrical ground. 


This is the analog output from the PSG. 


7 
Using the T/S 2068's 
Programmable Sound 
Generator 


The T/S 2068 has a built-in, sound-generating IC. This sophisti- 
cated “chip” is known as the Programmable Sound Generator, or PSG 
for short. (Technically speaking, the PSG is a General Instrument 
AY-3-8912.) Telling the PSG what to do is simply a matter of sending 
the proper bytes of data out through a pair of I/O ports. Specifically, the 
T/S 2068 uses ports F5h and F6h for communicating with the PSG. 
Port F5h is used to address one out of 15 registers within the PSG, and. 
the eight bits of data are written to (or read back from) the PSG via port 
F6h. From BASIC, there is a SOUND command which makes this task - 
slightly easier. 


_ INSIDE THE PSG 


If we could look inside the PSG, we would find 15 byte-wide registers 
arranged as shown in Fig. 7-1. These registers control the sound 
generated by this IC. To generate music or sound effects, the com- 
puter must send a series of commands to the PSG at precise times. In 
between commands, the PSG will continue to produce sound accord- 
ing to its last instructions. Thus, the CPU is free to perform other tasks, 
such as updating the screen or graphics display. This is one of the 
main advantages of using a hardware PSG versus the software gener- 
ated sound. 

The PSG can be broken down into six major functions (see Fig. 
7-2). We start with three identical tone generators. Each generator 
produces a square-wave signal at a software-controlled frequency. 
The exact frequency is determined by programming the coarse tune 
and fine tune registers associated with each tone generator. In addi- 
tion to the three tone oscillators, there also is a random-frequency 
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Fig. 7-1. Register layout of AY-3-8912 PSG. (Courtesy General Instru- 


‘ment:Corp.) 
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ais cies + DECAY 


TIME ——> 


Fig. 7-2. Block diagram of PSG. (Courtesy General Instrument Corp.) 


noise generator. This block creates a sound similar to the noise heard 
from a tv set when it is tuned to a channel that is not broadcasting. By 
controlling the sound produced by the noise generator, we can create 
the sound of percussion instruments, as well as many sound effects. 
The outputs from these tone generators and the noise generator are 
fed into a mixer section which controls which sound is to be fed into 
three D/A (digital to analog) converters. The purpose of these devices 
is to give control over the amplitude (loudness) of the signal. 

The D/A converters set the volume for each channel according to 
the data stored in the amplitude control registers. These registers can 
supply a fixed 4-bit value representing one of 16 logarithmically scaled 
amplitudes. Alternatively, each register can specify that the amplitude 
be controlled by the envelope generator which automatically causes 
the amplitude to rise or fall at a predetermined rate. Before describing 
how the PSG is programmed, we'll discuss a few basics of sound. 


AUDIO BASICS 


Sound is nothing more than a compression wave — molecules of air 
moving closer together and then farther apart. This wave is usually 
generated by some vibrating object. in the case of the T/S 2068, it 
comes from the moving diaphragm, or cone, of a small speaker inside 
the computer. When this speaker is fed an alternating current, it will 
move in and out according to the varying potential (voltage) across its 
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terminals. If this signal is made to alternate somewhere in the range of 
20 to 20,000 times per second, then our ears can detect (hear) the 
motion of the speaker. 

There are three characteristics of the voltage signal that can be 
discerned by our ears. First of all, there is the number of times that the 
voltage changes polarity (goes from positive to negative or vice versa). 
This determines the frequency or pitch of the signal. At 20 polarity 
reversals per second, the sound will be extremely low, almost like an 
earth tremor. To make the sound of a middle C note on the piano, the 
signal must have a frequency of about 260. cycles per second. The 
high end of the audio frequencies is at 20,000 cycles per second. This 
is usually written as 20,000 Hz or 20 KHz (Hz represents hertz, the unit 
of frequency and K represents 1000). 

Sometimes it is useful to refer to the inverse function of frequency. 
That is, how many seconds (or fraction thereof) it takes to complete 
one cycle. This is known as the period of a signal and can be 
expressed in seconds, milliseconds (thousandths of a second), etc. 
Converting from frequency to period, or vice versa, is simply a matter 
of dividing the number by 1. For example, a 200-Hz signal has a period 
of 1/200 or .005 second (5 milliseconds). 

Another characteristic of the voltage signal driving a speaker is the 
amplitude or level of the signal. This determines how /oud the sound 
emanating from the speaker will be. The amplitude can be constant, 
as in the dial tone you hear when you pick up a telephone, or it can vary 
in some manner to create a different sound. When you hit a cymbal for 
instance, the sound starts off very loud. As the cymbal continues to 
vibrate, the sound begins to die off, getting softer and softer until there 
is no sound at all. 

Sounds that have a varying amplitude can be broken up into three 
phases. The first phase consists of the time when the sound is 
beginning to increase in amplitude. This is known as the attack portion 
of the signal. If the signal maintains this amplitude for some length of 
time, then this is called the sustain portion. Finally, the sound enters 
the decay phase where the amplitude decreases, usually to zero. 
Sometimes repetitive combinations of these phases are strung 
together to form complex sounds. By drawing a line around the peak 
values of a given waveform, we can easily see what kind of variations 
are taking place in the signal’s amplitude. This is known as the enve- 
lope of the signal (see Fig 7-3.) 
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Fig. 7-3. Basic characteristics of an audio signal. 


The last important characteristic of a signal is its waveshape. This 
determines the timbre or voice of the sound. It's what makes a middle 
C note on the piano sound different from the same note played on a 
guitar. Actually it is the presence of harmonics, or multiples of the 
primary frequency, that give each instrument its individual sound. The 
only pure sound is that created by a sine wave which consists of only 
one frequency without any harmonics. A tuning fork creates such 
monochromatic sound. Other waveshapes such as the “square wave” 
signals created by the T/S 2068 are rich in harmonics. When we speak 
of the frequency of such a signal, we always refer to the most dominant 
or fundamental frequency. While there may be numerous harmonics 
present in the signal, they are all considerably lower in amplitude than 
the fundamental. 


PROGRAMMING THE PSG 


To understand how the PSG creates sounds, let's start with the input 
clock and the register array. These two criteria fully define the actual 
sounds that come out of the PSG. First, we have a master clock signal 
which the T/S 2068 creates and feeds to the PSG’s CLOCK input. This 
signal is nothing more than a square wave oscillating at 1.764 MHz 
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(that’s millions of hertz). Obviously this frequency is much too high to 
be heard by the human ear, so the PSG must reduce the signal into the 
audible range to be of any use. It does this with a series of circuits 
known as dividers since they divide the input frequency by some fixed 
amount to produce a lower frequency. The first thing that happens to 
the input clock is that it gets divided by 16. This, then, becomes the 
PSG's master clock which feeds the rest of the circuits. 


Setting the Frequency 


The PSG has three separate tone generators which can be indi- 
vidually programmed to create a single note. The actual frequency 
produced by each generator is equal to the PSG master clock divided 
by a 12-bit Tone Period value stored in the PSG's registers. For 
example, the Tone Period for the “A” channel of the PSG is comprised 
of Register 0 and part of Register 1. Fig. 7-4 shows a graphic repre- 
sentation of how this 12-bit value is formed. Although one half of 
Register 1 (hereafter referred to as R1) is not used, the lower four bits 
represent the most significant portion of the tone value. Therefore, R1 
is called the Coarse Tune Register and RO is the Fine Tune Register. 
Likewise for the other two channels B and C, there are two pairs of 
tuning registers, R2/R3 and R4/R85, respectively. 


COARSE TUNE FINE TUNE 
REGISTER CHANNEL REGISTER 


R3 B Re 
RS c R4 


[27 | ee 5} e+e] ee | es Jeo] HOODOO 
d \ 
\ 


\ a 
NOT \ / 
USED , 


12-BIT TONE PERIOD (TP) TO TONE GENERATOR 
Fig. 7-4. Tone generator timing registers. (Courtesy General Instru- 
ment Corp.) 


\ 
\ 
Na 8 
i 


Let's see what kind of tones we can generate with the PSG. With a 
12-bit divisor, we can represent any number between 1 and 4095 
(dividing by 0 is not allowed). With a 1.764 MHz input clock divided by 
16, we have a PSG master clock frequency of 110.25 KHz. This is the 
highest frequency obtainable using a tone period divisor of 1. At the 
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low end, we can get 110.25 KHz divided by 4095, or 27 Hz. This covers 
most of the useful audio spectrum. 

Note that the numbers stored in the Tune registers represent the 
period of the desired frequency. Therefore, a large number stored in 
the register corresponds to a low frequency tone. Also note that these 
division counters create a linear span of frequencies which have 
nothing to do with musical notes. The musical scale is based upon a 
logarithmic group of frequencies. Notes are arranged in octaves 
which represent a doubling of frequency and each octave is then 
subdivided into twelve equally tempered notes. Thus, every note is the 
twelfth root of two higher in frequency than the previous one. Table 7—1 
shows the actual frequencies associated with each musical note along 
with the values that must be stored in the tuning registers to approxi- 
mate them. Note that these are only approximations.as can be seen in 
the last column which shows the actual frequencies produced by the 
T/S 2068. 


Table 7-1. Register Values for Notes of Musical Scale 


Ideal Tune Registers Actual 
Frequency cone Fine Frequency 


32.703 32.705 
e 34.648 i re 34.648 
D 1 36.708 1] 187 36.713 
D# l 38.891 1i 19 38.889 
E 1 41.203 10 116 41.200 
F ] 43.654 9 222 43.646 
F# 1 46.249 9 80 46.246 
G 1 48.999 8 202 49.000 
G# l 91.913 8 76 51.907 
A 1 99.000 7 213 54.988 
A# 1 98.270 7 100 58.272 
B ] 61.735 6 290 61.730 
Cc 2 65.406 6 150 65.391 
C# 2 69.296 6 55 69.296 
D 2 73.416 5 222 73.402 
D# 2 77.782 s) 137 77.805 
E 2 82.407 5 58 82.399 
F 2 87.307 4 239 87.292 
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Table 7-1 — cont. Register Value 
for Notes of Musical Scale 


Ideal Tune Eosisan, Actual 
Frequency Coots? a Frequency 


92.492 

: 77 a P ie 98.000 

Gs 2 103.826 4 38 103.814 
A 2 110.000 3 |. 234 110.030 
A# 2 116.541 3 178 116.543 
B 2 123.471 3 125 123.460 
Cc 3 130.813 3 75 130.783 
C# 3 138.591 3 28 138.505 
D 3 146.832 2 239 146.804 
D# 3 155.563 2 197 155.501 
E 3 164.814 2 157 164.798 
F 3 174.614 2 119 174.723 
F# 3 184.997 2 84 184.983 
G 3 195.998 2 51 195.826 
G# 3 207.652 2 19 207.627 
A 3 220.000 | 245 220.060 
A# 3 233.082 1 217 233.087 
B 3 246.942 1 190 247.197 
Cc 4 261.626 1 165 261.876 
| C# 4 277.183 1 142 277.010 
D 4 293.665 1 119 294.000 
D# 4 311.127 1 98 — 311.441 
E 4 329.628 1 78 330.090 
F 4 349.228 ] 60 348.892 
F# 4 369.994 1 42 369.966 
G 4 391.995 1 25 392.349 
G# 4 415.305 1 ] 416.038 
A 4 440.000 0 251 439.243 
A# 4 466.164. 0 237 465.190 
B 4 493.883 0 223 494.395 
Cc SS) 523.251 0 211 $22.512 
C# 5 594.365 0 199 594.020 
D Ss) 587.330 0 188 586.436 
D# 5 622.254 | 0 177 622.881 
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Table 7-1 — cont. Register Value 


for Notes of Musical Scale 
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Ideal Tune Registers Actual 
Frequency course Fine ‘Fiedconss 


SC ONNNNN STS DDDAMDMAMADWMAAMBMHDMAMUMMKUMMHMHUHUM 


659.255 
698.456 


783.991 
830.609 
880.000 
932.328 
987.767 
1046.502 
1108.731 
1174.659 
1244.508 
1318.510 
1396.913 
1479.978 
1567.982 
1661.219 
1760.000 
1864.655 
1975.533 
2093.005 
2217.461 
2349.318 
2489.016 
2637.021 
2793.826 
. 2959.956 
* 3135.964 
3322.438 
3520.000 
3729.310 
3951.067 
4186.009 
4434.922 


739.989 


OCOo900ggo0o00C0CO8 C09 OCC CCOOMOOMOOOC OOO CO OoO°O 


167 
158 
149 


141 
133 


660.180 
697.785 
739.933 
781.915 
828.947 
882.000 
934.322 
984.375 
1050.000 
1113.636 
1172.872 
1238.764 
1312.500 
1395.570 


1489.865 . 


1575.000 
1670.455 
1750.000 
1868.644 
1968.750 
2080.189 
2205.000 
2345.745 
2505.682 
2625.000 
2826.923 
2979.730 
3150.000 
3340.909 
3556.452 
3675.000 
3937.500 
4240.385 
4410.000 
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Table 7-1 — cont. Register Value. 
for Notes of Musical Scale 


4698.637 4793.478 
4978.032 5011.364 
5274.041 5250.000 
5587.652 5512.500 
5919.911 5802.632 
6271.927 6125.000 
6644.876 6485.294 
7040.000 6890.625 
7458.621 7350.000 
7902.133 7875.000 


By the way, you might like to compare Table 7-1 with the chart on 
pages 187-189 of the 7/S 2068 User Manual. You will find that the 
frequencies given and the register values recommended are slightly 
different. The reasons for this are threefold. First, it seems that the 
actual frequencies presented in the Timex manual were calculated on 
amachine with limited accuracy. Therefore, there are some discrepan- 
cies in the last couple of decimal places. Next, when calculating the 
Coarse and Fine Tune register values, a couple more errors crept in. 
As evidenced by the program later in the chapter, we see that an 
approximation of 1.75 MHz was used for the clock frequency. We also 
see that the Fine Tune register value was truncated instead of being 
rounded to the nearest integer. Since ail of the values are really 
approximations to the correct frequencies anyway, we really should 
use all of the accuracy we can get. Listing 7~1 shows the program that 
generated the values in Table 7—1. 


Q 
0 
0 
0 
0 
0 
0 
0 


Noise Generator 


Aside from the three programmable tone generators, there is also a 
programmable noise generator in the PSG. This generates a random 
collection of frequencies that can be used in a variety of ways. Unlike a 
true white noise source which would generate all audio frequencies 
with equal amplitudes, this generator only produces a limited noise 
range. This range can be moved towards either the high-frequency or 
low-frequency end. This is accomplished by setting a five-bit value into 
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Listing 7-1 


19 LET x= 1764060/16 
26 LET b=27.5: LET s= 2? (1/12) 
38 FORi=3TO98 
46 LET a= (bssti) 
58 GOSUB 509 
68 PRINT a$;” ’; 
76 LET a=x/a: LET c=INT (a/256) 
80 LET f= INT (a—(c*256) + .5) 
98 IF c<1@ THEN PRINT” ’; 
91 PRINT c;” ”; 
166 IF <1 THEN PRINT ” ”; 
101 IF <1@@ THEN PRINT” ’; 
193 PRINT F:” ”; 
110 LET a=x/(c*256+f) 
129 GOSUB 566 
130 PRINT a$ 
406 NEXTi 
499 STOP 
566 LETa$=""+STR$ (at 665): 
FOR j=1TOLEN (a$): IF a$(j)=” .” THEN GO TO 593 
561 =NEXTj 
562  LETa$=a$+”.” 
503 LET a= (a$ + "G00") (j-4 TO j+ 3) 
504 RETURN 


REGISTER R6 


Le” | es | es | oe | co | e2'| or | 20 | 


ee 


NOT 5-BIT NOISE PERIOD (NP) 
USED TO NOISE GENERATOR 


Fig. 7-5. Noise Period Register. (Courtesy General Instrument Corp.) 


the Noise Period Register (R6). See Fig. 7-5. Using a low number 
gives a high-frequency noise that sounds somewhat like rain. A high 
number yields the lower pitched noise of wind rustling through the 
trees. By sweeping the noise spectrum from high to low, you can 
create the sound of waves crashing on the shore. 


Selecting the Tone and Noise Sources 


The Mixer Control Register (R7) takes care of selecting which tone 
or noise source will be sent to the output channels. Each channel (A, 
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B, or C) can contain either its respective tone generator or the noise 
source. The tone enable is represented by the lower three bits of R7. 
The noise enable is contained in the next three higher bits. Each “0” bit 
represents that the respective source is enabled or turned on. Storing 
a value of 63 at this location (111111 in binary) causes all sound from 
the PSG to be turned off. Bit 6 is used to control the direction (i.e., 
either input or output) of an I/O port which is part of the PSG. This is 
the port used by the T/S 2068 to read the status of the external 
joysticks. This bit must always be left at zero for the STICK command 
to work properly. Fig. 7-6 shows the breakdown of bits in R7. 


REGISTER R7 


NOT 
usep| 6 | 66 | 6 | 69 | 62 | 61 | 60 
4 
7 
Z 


\ \ 
\ \ 


FUNCTION 


0 PORT 


\ 
TONE ENABLE 
peje] a| 


FUNCTION 


NOISE ENABLE 
Pere t a 


CHANNEL 


NOISE ENABLE TRUTH TABLE: TONE ENABLE TRUTH TABLE: 


R7 BITS NOISE ENABLED R7 BITS TONE ENABLED 
B5 B4 B3 ON CHANNEL B2 Bi BO ON CHANNEL 
0 0 0 Cc B A 0 0 0 c BA 
oo 1 c B — oo 1 c B 

o 1 0 c -— A 0 1 0 c — A 

o 1 1 Cc -—- — o 1 1 c - - 

1 0 0 -—- BA 1 0 0 - BA 

1 0 1 - 8B - 1 0 1 a Bes = 

1 1 0 —- — A 1 $10 °-~- A 

ne - -- 1 1641 pe ee 


Fig. 7-6. Mixer Control Register. (Courtesy General Instrument 
Corp.) 


Using the T/S 2068's Programmable Sound Generator 125 


AMPLITUDE CONTROL 


REGISTER CHANNEL 
R8 A 
RQ B 
R10 c 
er]es]s]=]e=] ee] [=] 
ceo iN \ 
Nor / /\ \ 
USED s  / \ \ 
i i \ 
U i 
/ i \ \ 
/ U \ . \ 
| 
AMPLITUDE 4-BIT "FIXED" 
"MODE" AMPLITUDE LEVEL 


Fig. 7-7. Amplitude Control Registers. (Courtesy General Instrument 
Corp.) 


Setting the Amplitude 


Now that we have the frequency of the note(s) defined in the 
appropriate tune registers, we need to set the amplitude. There is an 
Amplitude Control register in the PSG for each of the three channels. 
These are R8, R9, and R10 for Channels A, B, and C, respectively. 
Each Amplitude Control register contains a four-bit “fixed” amplitude 
level and a one-bit amplitude “mode” control, as shown in Fig. 7-7. 

The amplitude mode bit selects either a fixed level (M =0) or vari- 
able level (M=1) amplitude. If the fixed mode is selected, then the 
four-bit amplitude value sets the loudness of the channel to one of 16 
preset levels. These levels are logarithmically related to compensate 
for the response of the human ear. The amplitude of a channel could 
be varied under software control by constantly writing new values into 
the amplitude register. The PSG, however, has a built-in mechanism 
for creating variable amplitude signals. 

When the amplitude mode bit is set to a “1”, another section of the 
PSG, called the Envelope Generator is used to control the channel's 
amplitude. The Envelope Generator supplies a four-bit value to the 
amplitude control which can dynamically change without any interven- 
tion of the CPU. At any given time, the output of the Envelope Gener- 
ator will depend upon the Envelope Period Control Registers (R11 and 
R12) and the Envelope Shape/Cycle Control Register (R13). See Fig. 
7-8 and Fig. 7-9. 
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COARSE TUNE FINE TUNE 
REGISTER R12 REGISTER R11 
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TO ENVELOPE GENERATOR 


Fig. 7-8. Envelope Period Control Registers. (Courtesy General 
Instrument Corp.) 


REGISTER R13 
[27] 66] 25 |e | os | 2] | 0] 
FUNCTION 
NOT 
USED HOLD 


- ALTERNATE TO 
ENVELOPE 
ATTACK GENERATOR 
CONTINUE 


Fig. 7~9. Envelope Shape/Cycle Control Register. (Courtesy General 
Instrument Corp.) 


_ The rate at which the amplitude will rise (attack) or fall (decay) is 
controlled by the Envelope Period Control Registers. These two regis- 
ters combine to form a 16-bit divisor which determines the envelope 
period. Before being fed into this programmable divider, however, the 
master clock is first divided again by 16. Thus the envelope frequency 
can vary from 1.764 + 16 + 16 + 1 = 6890 Hz down to 1.764 + 16 + 
16 + 65535 = 0.105 Hz. This last value corresponds to a decay period 
of 9.5 seconds. 

- Register 15 contains four bits which control the action of the Enve- 
lope Generator. These bits are labelled Hold, Alternate, Attack, and 
Continue. By setting these bits at the appropriate time, we can gener- 
ate any type of attack-sustain-decay amplitude envelope that we 
desire. 

The Hold bit determines whether the envelope control will generate 
a single attack or decay cycle or whether it will keep repeating. With 
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Hold = 1, the envelope will rise or fall — depending upon the value of 
the Attack bit-— and then maintain the last amplitude (either all the way 
on or all the way off) until the next command. When Hold=0, the 
envelope will continue cycling up and down at the frequency deter- 
mined by the.Envelope Period registers. The Alternate bit controls how 
the envelope cycles when Hold=0. If the Alternate=1, then the 
envelope will change direction at the end of each ramp cycle. Thatis, if 
the envelope started as an attack, it will begin to decay after reaching 
its maximum amplitude. This generates an envelope pattern that 
resembles a triangle wave. At the end of an attack cycle where 
Alternate = 0, the amplitude will return to zero and another attack cycle 
begins. This is known as a sawtooth pattern. 

The Attack bit determines whether the envelope generated will be 
an attack (Attack = 1) or a decay (Attack = 0). The Continue bit actually 
does not serve any useful purpose so it is best left as a zero. Fig. 7-10 

shows the resulting envelope shapes generated by the various set- 
tings of the Envelope Control bits. 


COMBINING THE OUTPUT CHANNELS 


The three outputs fromthe PSG are combined into a single SOUND 
signal. This signal is available at the rear expansion connector and is 
one of three signals that drive the speaker in the T/S 2068. 


OTHER EFFECTS 


Tremolo 


There are several musical effects obtainable from the PSG. One of 
these is called tremolo, which is the slight, rhythmical variation in a 
tone’s amplitude. This is accomplished by cycling through several 
fixed amplitudes at a constant rate. A program loop can create such a 
cycle, with the execution time of the loop controlling the repetition, or 
tremolo rate. The range of amplitudes used will control the depth of 
tremolo effect. By using just 2 or 3 values, there will be only a slight | 
warble effect. Increasing the range causes the effect to be more 
pronounced. Listing 7—2 contains a program to demonstrate the trem- 
olo effect. 
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ENVELOPE SHAPE/CYCLE CONTROL 


R13 BITS 
B3 62 B1 BO 


GRAPHIC REPRESENTATION 
OF ENVELOPE GENERATOR 
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= —P ee EP iS THE ENVELOPE PERIOD 
(DURATION OF ONE CYCLE) 


Note: Above waveforms only show positive 
side of envelope. 
For example, cycle 1110 creates a 
signai like this: 


Fig. 7-10. Envelope patterns available with the PSG. (Courtesy Gen- 
eral Instrument Corp.) 
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Listing 7—2 
186 LETa=13 . 
26 SOUND G,211;1,8: REM C5note 
38 SOUND 7,62;8,13: REM enable 


4 PAUSE 189: REM play note 

58 FORi=1TO8: READt: SOUND 8,a+t: REM do tremolo 
66 NEXTi: RESTORE: GOTO 5% 
186 DATAG,1,2,1,6,-1,-2,-1 


Vibrato 


129 


Varying the frequency of a note instead of its amplitude creates the 
effect known as vibrato. The program in Listing 7-3 demonstrates this 
effect. Note that the entire tone period value must be varied. Therefore, 
if the fine tune register must cross through a value of 0 or 255, the 
coarse tune register must be updated accordingly. To be equally 
effective on any given note, the depth of vibrato (lowest tone period - 


Listing 7-3 


186 LET f=211: REM C5 note 

26 SOUND G,f;1,6 

38 SOUND 7,62;8,13: REM enable 

46 PAUSE 199: REM play note 

56 FORi=1TO8: READ v: SOUND @,f+ v: REM do vibrato 
68 NEXTi: RESTORE: GOTO 56 
168 DATAG,1,2,1,8,-1,-2,-1 


highest tone period) should be proportioned to the absolute period. 


The program in Listing 7-4 compares the tremolo and vibrato effects. 


Listing 7-4 


1 LETa=13: LETf=211 
26 SOUND @,f;1,8: REM C5note 
38 SOUND 7,62;8,13: REM enable 
40 PAUSE 19: REM play note 
45 FORG=1TO5¢ 
56 FORi=1TO8: READ t: SOUND 8,a+t : REM do tremolo 
68 NEXTi: RESTORE : NEXT q 
76 FORQ=1TO5G 
86 FORi=1TO8: READ v: SOUND @,f+v : REM do vibrato 
98 NEXTi: RESTORE : NEXT q: GOTO 16 
188 DATAG,1,2,1,8,-1,-2,-1 
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Chords 


Playing several notes at the same time can create the pleasant 
sound of a chord. Table 7-2 shows how various chords can be 
created. A chord starts with its root note (the numbers in parentheses 
refer to the octave: —2 means down one octave, —4 down two 
octaves, etc.). Then a 3rd Minor or 3rd Major note is added to create 
either a minor or major chord. Any of the remaining notes can then be 
added to fill out the chord. See Listing 7-5 for an example of how a 
chord is played on the T/S 2068. 


Listing 7-5 


18 SOUND @,211;1,0: REM C5 
26 SOUND 2,167;3,0: REM ES 
38 SOUND 4,141;5,0: REM G5 
46 SOUND 7,56;8,15:9,15;19,15 
196 PAUSE 190 


Table 7-2. Chord Selection Chart 
(Courtesy General Instrument Corp.) 


8 | 
The Video Display 


INTRODUCTION 


When we interact with a computer, the primary output device 
through which information is conveyed is the video display. This is how 
the computer presents the results of most of its functions. The T/S 
2068 has four different bit-mapped, color display modes available to 
the user. These will be described in this chapter. 


VIDEO BASICS 


It would seem that the best place to start is at the beginning — with a 
primer on what video is and how it works. In its broadest definition, 
video refers to the presentation of information as a visual image, 
usually by some electronic means. Nearly all video displays are 
created on some form of cathode-ray tube (crt), better known as a 
picture tube. ! 

A crt consists of an electron gun assembly (see Fig. 8-1) and a 
relatively flat viewing area coated with a phosphorescent material. The 
electron gun contains a small wire filament that is heated by passing a 
current through it, much like an incandescent light bulb. This heating 
element gives off electrons which are attracted toward the face of the 
tube by a high voltage (generated by circuits within the television set or 
monitor). This voltage accelerates the electrons to a very high speed. 

When the electrons strike the phosphors on the ert screen, they 
cause it to glow, creating a small speck of light. The intensity of this 
spot is controlled by an electrode which varies the number of electrons 
leaving the heater area. Finally, the location on the screen where the 
electrons hit can also be manipulated by deflecting the beam of 
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electrons either electrostatically or magnetically. In most video dis- 
plays, the deflection is done by means of two magnetic coils wound 
around the neck of the cathode-ray tube. These are known as the 
deflection coils. When the proper signals are applied to,these coils, the 
electron beam can be directed left or right, up or down, at will. 

With few exceptions, video displays use a raster-scan technique. 
This means that the electron beam is constantly being swept, in a 
consistent pattern, across the entire screen. Starting in the upper-left 
corner of the screen, the beam is made to scan towards the right. 
Wherever information is to be displayed, the electron (or beam) current 
is modulated so that it illuminates only the desired areas. When the 
beam reaches the far right side of the screen, it is turned completely off 
(or “blanked”) and then rapidly returned to the left side in preparation 
for scanning the next line. At the same time the beam is also moving 
toward the bottom of the screen so that the next line will appear slightly 
below the previous one. When the beam eventually reaches the 
bottom of the screen, there's a similar blanking period during which the 
beam is brought back to its starting position. a 

To standardize the American television industry and to reduce the 
information needed to transfer a video image, the National Television 
System Committee (NTSC) was formed in 1953. This committee set 
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Fig. 8-1. Cathode-ray tube. 


The Video Display 133 


down the specifications for a raster-scan video system and further 
defined the frequencies, levels, and timing of the video signal. 

{t turns out that the electrical signal needed to deflect the electron 
beam horizontally and vertically in the appropriate fashion is quite 
easy to obtain. The waveform for this signal is known as a sawtooth, 
(so named for its resemblance to the ragged edge of a saw). Since this 
signal can be created by an oscillator circuit within the monitor or 
television, it need not be sent along with the video information from the 
camera, computer, or other video source. 

In acamera, for instance, there might be another sawtooth oscillator 
that causes an electron beam to scan the face of a video pickup tube. 
The output of this tube would vary according to the brightness level of 
the scene at the exact location of the beam. Thus, if the output of the 
pickup tube were connected to the input of the crt, it would “paint” an 
image on the screen of whatever the camera was focused on. 

There is, of course, one hitch. For the system to work properly, the 
scanning position of the pickup tube and the beam deflection of the crt 
must coincide with, and track, each other. Although the NTSC specifi- 
cation sets the frequency for these oscillators, some means of getting 
them “in phase” or synchronized must be provided. This is accom- 
plished by adding some special features, known as horizontal and 
vertical sync, to the video signal. See Fig. 8-2 and Fig. 8-3. 


SE EARING ACTIVE VIDEO 


HORIZ| COLOR DARK | DARK | LIGHT | PALE 
[sere] Steer | L_wre | suse | St 


CHROMA 


“WHITE” 
1 VOLT 


LEVEL 
{SATURATION) 
ee 
VOLTAGE { 


—_i___ 
LUMINANCE 


LEVEL 
iN (BRIGHTNESS) 
"BLACK" 90" 


ips CHROMA PHASE (TINT) 


REFERENCE SUBCARRIER 
(SHOWN FOR COMPARISON T7Me — 
ONLY; NOT PART OF 
VIDEO SIGNAL 


START OF 
HORIZONTAL LINE 
NOT TO SCALE 


Fig. 8-2. Video waveform for one horizontal scan line. 
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Fig. 8-3. Video waveform for one vertical field. 


The preceding holds true for both black-and-white and color trans- 
mission. When color television was first considered by the NTSC, it 
was decided that some means of adding the color information that 
would remain compatible with black-and-white standards needed to 
be found. A color tv camera works by separating the light from a scene 
into its red, green, and blue components. It’s like putting three black- 
and-white cameras together with a colored filter in front of each one. 
Since red, green, and blue are the primary colors, any other color can 
be broken down into a specific mixture of these colors. 

To be compatible with the black-and-white video standard, the RGB 
(Red, Green, and Blue) signals must be combined in a precise ratio to 
develop the brightness, or /uminance signal. By adding these three 
signals, we can create another signal which is identical to the output of 
a black-and-white camera. That takes care of the compatibility issue, 
but what about the rest of the color information? Well, itcan be proven 
mathematically that a set of mutually exclusive functions (such as the 
RGB primary colors) can be transformed into another set based upon 
any other mutually exclusive functions. By adding the RGB signals 
together we have already created one signal. If we add or subtract the 
R, G, and B signals in two other ratios, we can derive another pair of 
signals that represent only the color information. With proper proc- 
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essing, these signals can then be transformed to represent the hue 
(tint) and saturation (color intensity) information. 

The NTSC’s solution was to add a high-frequency subcarrier to the 
luminance signal. This could be both amplitude and frequency modu- 
lated (actually phase modulated) to carry the hue and saturation 
information. This subcarrier would ride along the video waveform so 
that to a black-and-white receiver it would pass unnoticed. With the 
proper circuitry in a color set, however, this extra signal could be 
reconstituted into the proper red, green, and blue signals to drive a 
typical color crt. 

As was the case with the horizontal and vertical sync signals, 
another color sync signal needed to be added so that the. receiver's 
color oscillator could be synchronized to that of the original video 
source. This additional signal is called the cofor burst because it 
consists of a burst of approximately nine cycles of the originating 
subcarrier reference oscillator. 

To summarize the NTSC color video system, let's consider its three 
separate parts. Both the sending and receiving devices contain three 
oscillators: a vertical one at a rate of 29.97 Hz, a horizontal one at 
15,735 Hz, and a subcarrier riding on 3.57945 MHz. Through these 
oscillators, the sending device creates a video signal with the following 
properties: 


1. There is a negative-going pulse to signify the start of each 
horizontal line and a similar signal to signify the beginning of 
each vertical field. 

2. The color reference subcarrier is modulated by signals repre- 
senting the red, green, and blue content of each portion of the 
active video field. These signals in turn create an am (amplitude 
modulated) and fm (frequency modulated) signal that rides 
along with the brightness or luminance signal. In particular, the 
phase of this subcarrier represents the hue, and the amplitude of 
the subcarrier corresponds to the saturation of the color. This 
subcarrier signal is referred to as the chrominance subcarrier, or 
simply chroma. The center point around which the subcarrier 
oscillates is thus the luminance level. 


Now that we know what kind of signal the T/S 2068 video generator 
must create, we will look at where the computer stores the information 
that we see on the screen. 
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DISPLAY MODES 


The information that the T/S 2068 displays on the screen comes 
from several special areas in RAM. These are called display files and 
attribute files and there are two of each. Their addresses are shown in 
Fig. 8-4. Normally, only the primary files are used, and the memory 
assigned to the secondary files is used by the system software. To fully 
utilize the secondary files, this system data must be moved elsewhere 
in RAM as discussed in Chapter 5. 


Display and Attribute ; 
File Addresses Hexadecimal Decimal 


Display File 1 4000-57FF 16384-22527 
Attribute File 1 5800-5AFF 22528-23295 
Display File 2 6000-77FF 24576-30719 
Attribute File 2 7800-7AFF 30720-31487 


Fig. 84. Display file and attribute file addresses. 


The display file holds a bit-mapped representation of the video 
display. This means that there is a one-for-one correspondence 
between each bit in the display file memory and the dots that make up 
the video picture. Each dot is also called a picture element, or pixel for 
short. Although the exact order of the bits in memory may not corre- 
spond to the relative position on the screen, there is a somewhat 
logical layout to the bytes in the display file. See Fig. 8-5. 

The attribute file contains information on the color, intensity, and 
flashing status for each character position in the display. The informa- 
tion represented by each attribute byte is shown in Fig. 8-6 and the 
layout of the attribute file is shown in Fig. 8-7. Note that three bits are 
used to represent each of the PAPER and INK colors. If you examine 
the bit representations, you will find that the least significant bit repre- 
sents blue; the middle bit red; and the most significant bit represents 
green. Various combinations, of course, yield their respective colors 
(e.g., 011 = Red + Blue = Magenta). Thus the T/S 2068 represents 
color information in an RGB format. 

A large portion of the T/S 2068's circuitry is devoted to the job of 
video generation. This is one of the major improvements that the T/S 
2068 made over the earlier T/S 1000 which had used the CPU to 
perform this task. Since video generation requires that a continuous 
signal be created and updated about 60 times per second, it required 
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a OF DISPLAY FILE 
—_____—___ 6144 BYTES TOTAL ——__________. 


32: BYTES 32 BYTES [secrecy 32 BYTES —+;-— 32 BYTES | 


oa FOR reer FOR DATA Rearend DATA FOR FOR 
ROW 1 ROW 2 ROW 8 ROW 1 
SCAN LINE 1 SCAN LINE 1 SCAN LINE 1 SCAN LINE 2 


{ 32 BYTES Jee] 32 BYTES 32 BYTES 32 BYTES E 


SSO 
DATA FOR DATA FOR DATA FOR DATA FOR 
ROW 8 ROW 8 ROW 9 ROW 10 
SCAN LINE 2 SCAN LINE 8 SCAN LINE 1 SCAN LINE 1 


START OF 
( 32 BYTES 32 BYTES feseeeeeeey 32 BYTES ATTRIBUTE FILE 


DATA FOR DATA FOR DATA FOR 
IW 16 ROW 17 ROW 24 
SCAN LINE 8 SCAN LINE 1 SCAN LINE 8 


Fig. 8-5. Display file organization. (Courtesy Timex Computer Corp.) 


that the T/S 1000 either stop making video while it was computing, or 
else run very slowly. 

In the T/S 2068 the video generator operates independently (but 
synchronously) with the CPU. To present information on the video 
display, the CPU has only to load the correct dot patterns into the 
display file and the appropriate color/intensity information into the 
attribute file. The video generator then constantly reads out these 
files, converting the information they contain into the three RGB 
signals. These signals are available at the card edge on the rear of the 
computer; this allows the T/S 2068 to be connected to monitors 
specifically designed to accept RGB signals. We'll have more to say 
about this later. The RGB signals also go to an encoder circuit which 
transforms them into the composite video signal which feeds the 
MONITOR jack and the RF modulator. 
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ATTRIBUTE BYTE FORMAT 


PAPER COLOR 
1= BRIGHT, 0=NORMAL 
1=FLASH, 0=STEADY 


INK COLOR 


PAPER OR INK COLOR 


VALUE COLOR 

7 111 WHITE 

6 110 YELLOW 
5 101 CYAN 

4 100 GREEN 

3 011 MAGENTA 
2 010 RED 

1 001 BLUE 

0 000 BLACK 


Fig. 8-6. Attribute byte structure. (Courtesy Timex Computer Corp.) 


START OF 
ATTRIBUTE FILE 


—____——_ 768 BYTES ——_____ 


32 BYTES 32 BYTES peer] 32 BYTES 


——$_—$——— —$—$—$——— re 
DATA FOR DATA FOR DATA FOR 
ROW 1 ROW 2 ROW 24 
Fig. 8—7. Attribute file organization. (Courtesy. Timex Computer 
Corp.) 
Display Mode 1 


In this mode, the T/S 2068 organizes the video display into 24 rows 
of 32 characters each. This corresponds to creating 256 pixels on 
each of 192 lines. One attribute byte is used for each character 
position (a character is made up of 8 x 8 pixels). The pixel data and 
attribute data are stored in their primary locations (D_ 
FILE 1 and A FILE 1). 
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Display Mode 2 


This display mode allows the computer to generate 24 rows of 64 
characters each. This corresponds to a graphic resolution of 512 x 
192 dots. Both display files are used. The odd numbered character 
positions come from D_FILE_1 and the even ones come from D FILE 2. 
No attribute file is used; therefore, the entire screen can only have one 
PAPER color and one INK color. The paper color is stored in a 
hardware register at port FFh. The ink color is chosen automatically by 
the computer as shown in Table 8—1. The low brightness and flashing 
attributes are not available in this mode. 


Table 8-1. Paper and Ink Combinations 
Available in Display Mode 2 


Port FFh 
BitS Bit4 Bit3 Paper 


Black White 
Blue Yellow 
Red Cyan 


Magenta Green 
Green Magenta 
Cyan Red 
Yellow Blue 
White Black 


You can see what the 64-column mode looks like by typing: 


OUT 255 +62 


This turns on Mode 2 with black paper and white ink. You will need a 
good, hi-resolution monitor connected to the MONITOR jack in order 
to see the presentation clearly. 

Note that the characters are now half as wide as normal. You can 
type on the computer, or do anything else with it as if you were in the 
regular mode. However, the upper portion of the screen will have 
strange looking “garbage” characters in every other position. In fact, 
as you press the keys, you will notice certain changing patterns on the 
screen. This is because the second display file memory is still being 
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used by the system software for data storage. The only effect of the 
OUT 255,62 command has been to cause this area of memory to be 
displayed on the screen. 


Display Mode 3 


This is the “secondary page” mode of the T/S 2068. It operates 
exactly like display mode 1 except that D FILE 2 and A FILE 2 are 
used. One of the reasons for having two separate display pages is that 
they can be used for instant reveal and simple animation. Without two 
pages, the computer would have to constantly update a single page 
with the new information to be presented. Updating an entire screen 
takes a finite amount of CPU time, and you would have to watch the 
computer draw each new screen. With two pages, however, the com- 
puter can be updating one page while the other is being displayed. 
Then it can simply “throw a switch’ to instantly reveal the newly drawn 
page and begin updating the first page. By alternating between these 
two pages, a crude form of animation can be created. 


Display Mode 4 


This is the Ultra High Color Resolution mode of the T/S 2068. It uses 
D FILE _1 to define the pixel data just as in mode 1. Instead of using 
A FILE 1 to hold the attributes, however, this mode uses D FILE 2. 
Since this display file contains eight times as much memory as the 
normal attribute file, it is possible to assign an attribute byte to each 
row of pixels within each character. This allows a wide variety of color 
displays to be generated by the T/S 2068. 


RGB VIDEO 


As previously mentioned, the video generator first created Red, 
Green, and Blue signals from the data stored in the display/attribute 
file areas of RAM. These signals can be used to drive an RGB monitor 
for high quality color displays. By using the RGB signals directly, such 
a monitor avoids the noise and distortion that are inevitable when the 
RGB signals are converted to a composite video signal and then back 
again. 
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Most RGB monitors require five signals: the Red, Green, and Blue 
video signals plus Horizontal and Vertical sync. These last two signals 
are sometimes combined into a composite sync signal. These signals 
are usually sent in digital form as TTL levels (transistor-transistor- 
logic, the most common form of digital electronic circuitry using +5- 
volt and 0-volt signal levels). The T/S 2068 has TTL compatible R, G, 
and B signals available at its card edge. However, there is no horizon- 
tal, vertical, or composite sync signal available. To obtain these sig- 
nals, it is necessary to feed the composite video signal (also available 
at the card edge) into a circuit that can extract the sync portion and 
translate it to TTL levels. If the monitor requires positive TTL sync, 
then the circuit must also invert the sync waveform since the com- 
posite video signal uses negative going sync pulses. An RGB adapter 
should be available by now from the Timex Computer Corporation. 
When using RGB, however, the intensity attribute (set by the BRIGHT 
instruction) is ignored. 


PART 2 
MACHINE 
LANGUAGE 


SECTION A 
PROGRAMMING THE Z80 


9 | 
Introduction to Machine 
Language Programming 


We shall now examine how to program the Z80 in machine lan- 
guage. We have covered most of the hardware aspects of the CPU; 
now we'll explore the software side. The principles of machine lan- 
guage programming are not too different from BASIC programming. 
We must devise a procedure, or algorithm, to solve a problem and 
then turn that into a series of program steps within the constraints of 
the programming language. We'll examine these constraints a little 
further. 


BASIC VS. MACHINE LANGUAGE 


Every BASIC program written on the T/S 2068 follows a given set of 
rules. The program consists of lines or statements which themselves 
follow a given set of rules. These lines are executed sequentially 
unless specifically directed to jump or GO TO another line number. We 
define various data elements as either constants or variables in either 
numerical or character (i.e., string) format. Variables are referred to by 
“names’ which are usually chosen to help remember their meaning. 
Within each statement, the data is manipulated using the approx- 
imately 100 different commands that are understood by the T/S 2068 
BASIC interpreter. These commands include the simple arithmetic 
operations as well as higher mathematics such as trig functions. Thus 
writing a program is simply the act of stringing these instructions 
together in the proper order to produce the required results. 

Machine language programs also follow a rigid set of rules. Again, 
we can define a program as a list of statements which execute sequen- 
tially unless explicitly diverted. As far as a machine language program 
is concerned, however, all data looks the same — it's simply a “bunch 
of bits.” The Z80 doesn’t know whether a given byte represents part of 
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a floating point number or one character of a string. It is strictly up to 
the machine language programmer to keep track of things. One way to 
do this is by creating certain data structures that help define the 
program. We have already seen several examples of data structures 
used by the T/S 2068 BASIC interpreter: numerical values are stored 
in 5«byte blocks (fixed length data structure), string variables are 
stored in a variable length data structure, and the BASIC program in 
memory is stored as a linked-list. Keep in mind that these structures 
merely refer to blocks of memory and are identified to the Z80 by their 
absolute starting address. Actually, we can assign names to such 
variables or lists if we have an assembler (more on this later), but to the 
Z80 everything is still simply 8 bits times 65,536 locations. Finally, 
unlike the BASIC interpreter which understands about 100 com- 
mands, the Z80 has an “instruction set” of only 50 or so unique 
functions. (Most Z80 instructions have. many variations, however.) 
These instructions are all very simple compared to their BASIC coun- 
terparts. For example, the Z80 only has instructions for adding and 
subtracting 8 and 16-bit numbers. All other mathematical operations 
require multiple Z80 instructions arranged in a small routine to accom- 
plish the given function. Some examples of this will be shown in 
Chapter 12. 


HAND-CODING VS. AN ASSEMBLER 


Before delving into Z80 machine language programming, we must 
decide how we are going to write programs and get them into the T /S 
2068. There are two ways to write programs: hand-coding or using an 
assembler. Both methods start off by defining the problem in terms of 
the Z80's capabilities. A sequence of Z80 instructions is then written 
down which will accomplish the desired task. 

Each instruction is referred to by a mnemonic code. When hand- 
coding a program, the one or more bytes that represent this instruc- 
tion, i.e., its op code, are looked up in a table and written down next to 
the instruction. Any related data bytes are also written down in the 
proper order to derive the exact sequence of bytes that represent the 
desired program. 

Using an assembler makes things much simpler, however. The 
mnemonic program is typed directly into the assembler which auto- 
matically converts it into the proper bytes in memory. Various other 
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features such as line labels and variable labels (similar to BASIC line 
numbers and variable names) are also supported. Another great 
feature of an assembler is in calculating relative offsets and jump 
locations which may change as the program is modified. As we will 
soon see, adding one instruction to an existing program can require 
many changes. With hand-coding, each change must be identified 
and corrected manually. 

Despite the advantages of using an assembler, we are going to 
proceed with hand-coding our examples. The reason for this is quite 
simple. At the time this book was being written.there was no assembler 
program available for the T/S 2068. Anyone serious about machine 
language programming, however, will eventually want to have an 
assembler (there should be some available by now). Although we don’t 
have an assembler, we can still write programs in “assembly lan- 
guage” complete with instruction mnemonics and labels. Then we will 
go back and play human assembler — looking up op codes, calculat- 
ing offsets, and eventually generating the hexadecimal bytes which 
represent the given program. To enter the program into the T/S 2068, 
we then have to convert the hex numbers into decimal and POKE them 
in from BASIC. While this takes much more time and effort than using 
an assembler, it offers a great opportunity to learn about the Z80 and 
how it is programmed. 


UNDERSTANDING THE Z80 DOCUMENTATION 


Our approach to learning machine language programming will cen- 
ter upon one theme — understanding completely the Z80 instruction 
set. The charts presented in the next few chapters outline everything 
you need to know about what each instruction does. 

Just to get a feel for the usefulness of these charts, take a look at the 
column headings in Table 10—1. The first column shows the mnemonic 
for the given instruction. This includes separate representations for the 
various types of operands that can be used with each instruction. Due 
to the variety of addressing modes available with the Z80, there may 
be twenty or more different forms of a given instruction. The eight-bit 
LD (load) instruction, for example, has 21 varieties. 

The next column shows a symbolic representation of the operation 
performed by the instruction. Arrows are used to denote the flow of 
data. The next eight columns show the effect of the instruction on each 
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bit of the flag register. There are five distinct possibilities for the 
outcome of each bit. By executing the instructions, a flag bit can be 
“set” (=1) or “reset” (=0), left unaffected, or left in an unknown state. 
The last alternative is that the flag bit is set or reset according to the 
result of the operation performed by the instruction. 

The next two columns give the numeric representation of the 
instruction, or op code, in both binary and hex form. Many instructions 
apply to more than one register so a generic form is listed for the op 
code. Substituting the proper bits for each of the required registers will 
yield the exact binary representation for the instruction. 

The last three columns give information on the number of bytes 
used by each instruction and the number of machine cycles needed to 
execute it. Normally, these columns can be ignored unless a very time- 
sensitive routine is being written. 


THE USR COMMAND 


To execute a machine language program from BASIC, the USR 
command is used. This is a cross between the BASIC GO SUB 
statement and the machine language CALL instruction. Actually, USR 
is a function so it requires a preceding action command such as 
PRINT or LET. It also requires a parameter which in this case is the 
address to begin executing at (in decimal). Thus, a machine language 
routine located at address 1000 can be executed by any one of these 
lines: 


10 LET x = USR 1909 
20 PRINT USR 109 
30 RANDOMIZE USR 1900 


All of the preceding statements cause a machine language routine to 
execute until a RETurn instruction is encountered. This returns control 
to the BASIC program which then continues with its next statement. 
Upon entering the machine language routine, the BC register pair will 
hold the starting.address of that routine. With the exception of the IY 
and | registers, the routine is free to use any of the CPU registers. Their 
values prior to the USR call are automatically saved on the machine 
stack. Upon returning to BASIC, the interpreter will restore these 
registers to their proper value. The BC register pair, however, can be 
used to pass back data from the machine language routine. The 
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contents of this register will be assigned as the value of the USR 
function. Thus, in line 10, the value in register BC will be assigned to 
the variable x. This is a full 16-bit integer value. 

In line 20, the value returned will be printed out on the screen. Line 
30 shows a method of calling a routine which does not pass back any 
data. This avoids the need for a “dummy variable” or the printing of 
extraneous numbers on the screen. 


THE Z80 INSTRUCTION SET 


The remainder of this section will describe each of the Z80 instruc- 
tions in detail. Chapter 10 will introduce the simple LOAD instructions 
for moving information between memory and the CPU. All of the 280 
addressing modes will be described. Chapter 11 continues with 
instructions that affect program flow. These include jump, call, and 
restart instructions. Chapter 12 will discuss arithmetic and logic opera- 
tions. Routines for multiple precision addition, subtraction, and multi- 
plication are described, as well as a routine to perform division. Finally, 
Chapter. 13 concludes with the advanced Z80 instructions, including 
block moves, searches, and I/O operations. 


10 | 
Moving Information: 
The Load Instruction 


Machine language programs spend much of their time transferring 
data between the CPU registers and memory. Moving data is the 
function of the Z80’s LOAD instructions which are very similar to the 
LET statement in BASIC. There are many varieties of this instruction, 
So it will be helpful to break them down into at least two groups: the 8- 
bit LOAD group and the 16-bit LOAD group. As its name implies, the 8- 
bit load group transfers one byte of data per instruction. Note that 
whenever we speak of the transfer of data, we are actually talking 
about reading the contents of some source location and then copying 
the same pattern of bits into the destination location. These locations 
can be CPU registers, RAM or ROM memory locations, or even I/O 
ports. It is also important to note that the contents of the source 
location always remain unchanged (unless, of course, the source 
location also happens to be the destination location). The previous 
contents of the destination location are always lost when the new data 
is written there. 


REGISTER ADDRESSING 


Table 10-1 shows the 8-bit LOAD group of the Z80. All of the 
instructions start with the LD mnemonic which is short for LoaD. 
Starting at the top, we have the LD rs instruction. Here r and s refer to 
any of the following registers within the Z80: A,B,C,D,E,H, or L. As the 
symbolic description to the right implies, the contents of register s are 
copied into register r. Since both the source and destination locations 
are registers, this instruction is called a register to register load. 
Register addressing is relatively simple (there are only seven to 
choose from) and extremely fast. Since it only takes 3 bits each to 
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Table 10-1. The 8-Bit LOAD Group 
(Courtesy MOSTEK, Corp.) 


Symbolic Flags Op-Code No. of |No. of M jNo. of T 


Mnemonic | Operation |S [27 [HH] [P/V] N[C [76 543 210] Hex | Bytes | Cycles | States | Comments 
LOr,s ts *rerx}e;xtepele soir s 1 1 4 LS Reg. 
Lora ren eye; xpe;rxfet ete loo r 110 2 2 7 000 B 
- nA = 001 c 
LOr, (HL) v—~ (HL) eye; xte?;xtej]efe jorr 110 1 2 7 010 Oo 
LDr, (Xd) r~(IXed) fe fey xpe;xfe] ef eo iit 011107 ia) 3 5 19 Ot E 
Orr 110 100 H 
-d- 101 t 
LO r, (IY¥+d) c-Ul¥ed fe Pe rx peg xpef ede dat sito FO 3 5 19 WwW A 
Or 110 
adj se , 
LO (HL), (HL) —r ete; xX; e; xed e}e lorie: 1 2 7 
LD {IX+d), ¢ (X+djer fe felxje;xfej ef eit 010101 oo 3 5 19 
01110 FF 
ar pee 
LO (1Y¥+d), 5 (Yedi—r Je fe txte|xpefel]e fy 111107 FD 3 5 19 
O10 6 
ae 
LO (HL), {HU ~n ey7eyxXie] xe efe [00 110110 36 2 3 10 
-~A ie 
LD (1X+d), n UXtd—-a fe fer xte] xed ete ii 011101 oD 4 5 19 


00 110110 | 36 
-d + 
ae 

LOUY4d)n fllved—n fe fet xtetx fel efe ti itio | ro |a4 5 19 
coord | 36 
-~-d + 


LOA,(BC) =|A~(8C) fe fet xfetx fie] ee foo oro | oa [4 2 7 
LDA,(DE) =J{A—(0E) Je fe} xfe]x fe] ele foo oom | wa [1 2 7 
LO A, (nn) A-tnn) Je petx}elxfelefe looms | 3a 13 4 13 
nh 
i . --n = 
: LD(BC,A |(BC~A fe Jo tx{elxitetele loo conom | o2 |1 2 7 
LO (OE), A (DEA fe fe] xje}x fe}ele joo ciao 12 1 2 7 
LO (nn), A (nn)-A Je feyxieyxiefe le joo moo } 32 13 4 13 
3S Giles! 
shiny 3S 
LOA! A~I ty t)x pox peel] of © dis 101101 ED {2 2 9 
01 010111 57 
LDA,R A-R Sit] x]o]x feel oa] © far 101101 EO }2 2 9 
1 ont 5F 
LOLA 1-A eye Tx fel] x te fete [tr 109101 ED {2 2 9 
01 ooo11 | 47 
LOR,A R~A eo fetxpe dx ]e fe fe fit 101101 Eo }2 2 9 


Or 001111 4F 


Notes: —r, S means any of the registers A, 8, C, D, E, H, L 
tFF the content of the interrupt enable flip-flop (1FF) is copied into the P/V flag 


Flag Notation: = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
ts flag is affected according to the result of the operation. 


specify the source and destination registers, the entire instruction can 
be contained within a single byte and executed in one machine cycle. 

To see an example of how this instruction would be used, suppose 
we have some data in the A register that we wish to move into the B 
register. The mnemonic code would be: 


LD B:A 
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To calculate the binary representation of the op code, we start with 01, 
add 000 to specify B as the destination, and finish up with 111 indicat- 
ing A for the source. This gives us an op code of 01000111 or 47h. You 
can also verify this by checking the op code chart in Table 10-2. 
Locate the column for register A as the source and the row for register 
B as the destination. The intersection gives 47 as the correct op code. 
You should also note that none of the flag bits are affected by this 
instruction. 


Table 10-2. Op Codes for 8-Bit LOAD Group 
(Courtesy MOSTEK, Corp.) 


SOURCE 


a 
njaws 
S| ™O/< 


a59 
egale 


. 


REGISTER 


vas 


Geolake 
agleag 
Ganlagalsan 
g3/°Rs 


e29 
an 
a9 


DESTINATION 


REG 
INDIRECT 


IMPLIED 


IMMEDIATE ADDRESSING 


The next form of LoaD instruction to consider is that shown by the 
following mnemonic: 


LD ren 


Here, as before, r represents one of seven possible registers for the 
destination. In this case, however, the source of data, n, is the next byte 
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following the op code. Therefore, this instruction requires two bytes — 
one for the op code and another for the data. When this instruction is 
executed, the Z80 looks at the second byte and then copies that data 
into the selected register. ; 

This method of supplying the data within the instruction is called 
immediate addressing. That is, the source data is found immediately 
following the op code. For example, if we wanted to load register C with 
a value of 40, the instruction would look like: 


GE 28 LDC; 40 


Notice that we have written some (hex) numbers in front of the instruc- 
tion. These are the hexadecimal bytes that represent the given instruc- 
tion. This format of writing the hex notation to the left of the mnemonic 
representation is standard for an assembly language listing. Even 
though we will be assembling our code by hand, it proves to be a 
convenient and efficient way of showing both forms at one time. 
Therefore, whenever writing machine language code, leave enough 
space to fill in the hex codes to the left as they are determined. 

To see how these hex numbers were derived, start by looking up the 
op code for loading register C with an immediate value. From Table 
10—2 we find that the code should read OE n (where nis the data). Thus 
the first byte must be OEh. The instruction specified a data value of 40 
without explicitly indicating its base. Therefore, it is assumed to be a 
decimal number which needs to be converted into hex before it can 
become the second byte of the instruction. Doing the conversion gives 
us 28h for the second byte. Therefore, the complete hex representa- 
tion for the instruction is OE 28 as shown. 


REGISTER INDIRECT ADDRESSING 


The next entry in the 8-bit LOAD group demonstrates the use of 
register indirect addressing. Indirect addressing refers to a method 
whereby the data resides in a memory location, and the address of that 
location is placed in one of the 16-bit register pairs within the Z80. The 
CPU, therefore, must look to that address to find the data. (This may 
sound a bit confusing, but it is a very common procedure for the Z80 
and can be very powerful.) 
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Of course, to use any of the register indirect load instructions, we 
must first set up one of the register pairs with the desired address. 
Note from Table 10—2 that any register can be loaded using the (HL) 
indirect addressing mode. The other register pairs, however, can only 
be used for loading the A register. 

For example, if we needed to load register D with the contents of 
memory location 1000h we would write: 


LD H+19h 
LD L+2Dh 
LD D+(HL) 


See if you can fill in what the correct hex codes should be. When we 
discuss the 16-bit LOAD group, we will find an even easier way to load 
the HL register pair. Remember that whenever we use parentheses 
around a 16-bit value, we are actually referring to the 8-bit data stored 
at the 16-bit address. Therefore, you should read HL as the value 
stored in the HL register; but (HL) means “the value stored at the 
address pointed to by the HL register.” 


INDEXED ADDRESSING 


One of the most powerful addressing modes of the Z80 is known as 
indexed addressing. The mode makes use of the two special pur- 
pose, 16-bit, index registers: IX and IY. While these registers are 
capable of holding a complete memory address, the term indexing 
refers to the fact that we can add an offset, or displacement, to the 
address to form a new effective address. This effective address is then 
used as the source or destination location for the data. 

One of the most common uses for indexed addressing is when 
dealing with data that is stored in tabular form. in this case, the index 
register would be loaded with the starting, or base, address of the 
table. To find a given element in the table, we would then only need to 
know its position (i.e., displacement) from the beginning of the table. 
This would then become the displacement value used in the instruc- 
tion. Indexed loads require three bytes of code — two for the op code 
and one more for the displacement. A typical instruction might look like 
this: 


DD 4604 LDBs (IX +4) 
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EXTENDED ADDRESSING 


When passing data to or from the A register, a special form of 
extended addressing can also be used. This is sometimes referred to 
as direct addressing because the address for the memory location is 
directly contained within the instruction. In fact, it is palced in the two 
bytes following the op code. As will be the case with all addresses 
stored by the Z80, the low byte of the address is stored first. For 
example 


3A9B10 LDA» (199Bh) 


With this instruction the contents of memory location 1000h would get 
loaded into the A register. 


IMPLIED ADDRESSING 


The last four load operations in Table 10—1 refer to transfers between 
the A register and the special purpose | and R registers. We won't have 
too much to say about these instructions except that they define 
another type of addressing mode. Since both the source and destina- 
tion locations are completely specified by the op code, these instruc- 
tions are said to use implied addressing. Also note that LD A,! and LD 
A,R are the only 8-bit load instructions that affect the flag bits: the H 
and N bits are reset, the S and Z bits are set according to the value 
loaded, and the P/V flag gets set to the state of a special-purpose 
circuit within the Z80 called the Interrupt Flip-Flop. 


16-BIT LOAD GROUP 


Next we shall describe the 16-bit Load group. These instructions 
perform exactly like their 8-bit counterparts except that 2 bytes get 
transferred at the same time. Table 10-3 and Table 10-4 outline this 
group of instructions. . 

The first thing to notice from Table 10—4 is that almost no register- 
pair to register-pair loads are allowed. The exception is between the 
special SP register and the IX and IY registers. Most register pairs can 
be loaded with an immediate 16-bit value, however. This is known as 
immediate extended addressing. The value is contained in the two 
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bytes following the op code (low byte first, of course). So we could 
have: 


219012 LDHL+192@0h 


Table 10-3. The 16-Bit LOAD Group 
(Courtesy MOSTEK, Corp.) 


Symbolic Flags E Op-Code No. of | No. of M] No. of T 
Mnemonic Operation [S[Z] [H]| [PV] NYC [76 S43 210] Hex | Bytes | Cycles | States | Comments 
LD dd, nn dd ~ an ele; xi}e]x]e]e¢ | ©] 00 dd0 001 “$3 3 10 dd Pair 
- no 00 «BC 
-n 07 «DE 
LO IX, nn IX + nn ele] xileyxjefe @ 741 071 101 oo 4 4 4 10 HL 
00 100 001} 21 11 SP 
ae ees 
= oe 
LD IY, na lY =an ele] xte[xfele | elaran tor] ro fa 4 14 
00 100 O01) 21 
-~ n= 
ont = 
LOHL, (nn) | H = (nnsth Pepe] x}e]x]efe] | 00 101 oro] 2a | 3 5 16 
Lo o= (nn) - nh = 
a 
LO dd; (nn) ddy~(nntt) fe} e |] Xfe]x}e}e |e} it tot 101 ED 4 6 20 
dd_ ~(nn) Ot dd? O11 
- ad 
= 1 
LOIX, {nab | IXH— (natty) | ele] X}e tx fete |e} 11 oi 11t oD 14 6 20 
IXt (nob 00 101 010} 2A 
~ aA = 
-~a- 
LO LY, (nn) VWue(antt) | e pe yx pe |x fe fe | ef titi 101f FO 4 6 20 
Y¥y = (na) 00 101 O10} 2A 
- a = 
~naoo 
LO (nn), HL | (anti) ~ H efeyxie [Xie fe | ©] 00 100 O10; 22 3 5 16 : 
(an) = a ied 
~r- 
UD (naldd =f (nntt)—-ddyf efe | xX}eyxie pe je] it 101 1orf EO 4 6 20 
(nn) dd Q1 dd O11 
-~_ 1 
-A = 
LO (nn), 1X (nntt) IXY] epee EX fe | Xp ese @ 711 O1f 101 oo 4 6 20 
(nn) 1X7 00 100 O10f 22 
-AaA 
: baie mi 
LD {nn}, 1Y Inntth~l¥pfPe}etxie |X tele je] iti ity Fo 4 6 20 
(nn) —1¥, 00 100 010) 22 
~a = 
-~ava - 
LO SP, HL SP = HL eye ;xjeyxjeqe @] 11 111 001 FQ 1 1 6 
LOD SP, 1x SP ~ IX eText e expe fe |e] tf ort 101 oo 2 2 10 
11°117 Ot] FO 
LD SP, 1Y sp ~ iy ele rxfe yx fede |e] il tit 101 FD 2 2 10 
14:°411 GOT] FO aq Pair 
PUSH aq ($P-2)~aqar]* |e px}eeXx fe ]e |e] 41 qqd 101 1 3 W ao 468C 
{SP-1) ~ qqy o1 OE 
PUSH IX (SP-2)-iX_]} @ fe |] xX]eyX}e fe | ©] 11011 101 00 2 4 16 10. HL 
(SP-1) ~ IXy 11100 101] E5 M1 AF 
PUSH IY (SP-2) ~1¥p}efe|]xfe lx fete @ | 11 414 101 FO 2 4 15 
(SP-1) 1H 11=«100 101 ES 
POP qq qaH~(SP#1) |e |e | xX}e]xX fe fe |e] 11 qqd 001 1 3 10 
aqy ~ (SP) 
POP IX IXq+{SP+1) [*@ }e |X pe |x fe fe |e] 110 tor] oD 2 4 14 
IX, =(SP} 11:100 001) £1 
POP IY WHo-tSP+t) Je fe px fe |x fe fe |e] 41111 109 FD 2 4 14 
1¥, ~(SP} 11100 001] E41 


Notes: dd is any of the register pairs BC, DE, HL, SP 
gq is any of the register pairs AF, BC, DE, HL 
{PAIR}, (PAIR), refer to high order and low order eight bits of the register pair respectively. 
eg BCL=C, AFH=A 
Flag Notation: © = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
flag is affected according to the result of the operation. 
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Table 10-4. Op Codes for 16-Bit LOAD Group 
(Courtesy MOSTEK, Corp.) 


SOURCE 


DESTINATION 


DMA-OMD 


PUSH 
INSTRUCTIONS ™ 


NOTE: The Push & Pop Instructions adjust PoP 
the SP after every execution INSTRUCTIONS 


Of course, this is equivalent to the following 8-bit loads: 


2E 2 LDL+2Oh 
2612 LDHs18h 


As can be seen, the 16-bit instruction uses one less byte and it also 
executes faster. 

We can also use extended or direct addressing to specify a given 
memory location. But this only gives us a single 8-bit value — not 
much use for a 16-bit load instruction. Therefore, the CPU must look at 
another location to get the other half of the 16-bit data. This is exactly 
what the Z80 does, as shown by the symbolic representation of the LD 
HL, (nn) instruction. The L register is loaded with the contents of 
location nn; the H register is loaded with the contents of location nn +1. 
This conforms to the Z80’s standard of storing the lower order byte of a 
16-bit value first. Thus, if memory locations 1000h and 1001h con- 
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tained an important memory address, we could load the complete 16- 
bit address with a single command: 


2A 9919 LD HL +(1880h) 


The last form of 16-bit load instruction uses the Stack Pointer (SP) 
register as a memory pointer (indirect addressing). These instructions 
are referred to as the PUSH and POP instructions because they 
operate on the machine stack. What makes these instructions differ- 
ent, aside from using the register indirect addressing mode, is that 
they also alter the SP register itself after executing. That is, after each 
PUSH instruction, the SP register is decremented by 2. Conversely 
each POP instruction adds 2 to the Stack Pointer. Although not 
explicitly shown in the symbolic descriptions of these operations, you 
should remember that a PUSH instruction also performs SP ¢ SP — 2. 
And POP does an SP ¢SP + 2. None of the flag bit are affected by a 16- 
bit load instruction. 


| ll | 
Program Flow: JUMP 
CALL, and RETURN 


- Having machine language programs execute in sequential order 
from start to finish is not very useful. Computer programs (whether 
they’re machine language or BASIC) gain versatility through the use of 
decision making and branching instructions. Structured programming 
and memory savings are the benefits derived from the use of sub- 
routines. In. BASIC, we have the GO TO, GO SUB and RETURN 
statements. Their machine language equivalents are the JUMP, 
CALL, and RETURN groups. 

Table 11-1 and Table 11-2 outline the JUMP instructions. The first 
type of jump is called an unconditional jump and it has the form: 


JP nn 


Like the BASIC GO TO statement, this instruction always causes the 
program to jump to the address nn and then continue executing there. 
Note the symbolic form for this instruction: 


PC @nn 


This instruction merely places the two-byte address nn into the Pro- 
gram Counter (PC) register. Since the PC register determines from 
where the next instruction will be read, altering the PC has the effect of 
jumping to a new sequence of program instructions. 

The next form of jump instruction is known as the conditional jump. 
This resembles the IF . . . THEN GO TO structure used in BASIC. The 
conditions which can be tested are the states of several flag bits. 
These are shown in Table 11-2 under the heading “CONDITION.” If the 
specified condition is met, then the jump instruction will be executed. 
Otherwise, the program continues with the next sequential instruction. 
To. see an example, suppose we have the following two program lines: 
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Table 11-1. JUMP Group 
(Courtesy MOSTEK, Corp.) 


Symbolic Flags Op-Code No.of | No.of MjNoof T 


Mnemonic | Operation [STZ] [H] —JPW[N | © [Fe 643 200 Hex | Bytes [Cycles [States | Comments 
JPon PC nn ote X}e xle [fe |]e fii 000 O11) C3 |) 3 3 10 


- As Condition 
JP cc, an {fconditionce }® |e | Xje | xXle pe ye [it cc 010 3 3 10 000 | NZ non zero 
is true PC ~ nn, ~ nr + 001 |Z zero 
otherwise - nie 010 | NC non carry 
continue O11 fC carry 
100 | PO parity odd 
101 | PE parity even 
110 ]P sign positive 
JdRe PC - PC +e ele} xfer xe |e fe {00 017 OOO} 18 | 2 3 12 111 | M_ sign negative 
~e2 - : 
JR Ce i#C=0, ele | xileyxte fe fe joo 11 ooo} 38 | 2 2 ? If condition not met 
continue ~e2 ~ 
Weel, 2 3 12 H condition is met 
PC ~ PCte 
JR NC, e C=, eleyxje | xje fe ye joo 110 000) 30 | 2 2 7 If condition not met 
continue -e2 + 
1f C= 0, 2 3 12 If condition is met 
PC = PC+e 
IR Ze ifZ=0 ele|xie]xje[e]e {00 101 000) 28 | 2 2 7 If condition not met 
continue -e2 + 
WZ=1, 2 3 12 If condition is met 
PC ~ Pte 
JRNZ,e 2-1, ole] xe 1x] le] {00 100 000; 20 | 2 2 7 If condition not met 
continue -~e2 + 
WZ=0, 2 3 12 lt condition is met 
PC ~ PC+e 
JP UHL) PO -HL ele[xiefx]e fede [tt tor oo 9) 1 1 4 
JP (IX) PC ~ IX eje|xie | xje fe je fit on to 00) 2 2 8 
11 101 G01} ES 
JP (HY) PC -1Y ele jyxie]xje fee fit ity toy FO] 2 2 8 
41 101 OO1] ES 
DJNZ,e B- B81 e}eixje | xe fe fe joo 010 000) 10 | 2 2 8 #B=0 
1fB= 0, -e2 + 
continue 
1fB #0, 2 3 13 WB #0 
PC ~ PCte 


Notes: _ e represents the extension in the relative addressing mode. 
e is a signed two's complement number in the range <126, 129> 


e-2 in the op-code provides an effective address of pc+e as PCis 
incremented by 2 prior to the addition of e. 


Flag Notation: © = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
4 = flag is affected according to the result of the operation. 


ED SF . LDArR 
C2 09 12 JPNZ + 1299h 


The first instruction loads the A register with the contents of the R 
register. After executing this instruction, the Z flag will be set according 
to the value just transferred. If the value was zero, then the Z flag wil! be 
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set (=1). Otherwise, it will be reset (=0). According to this condition, 
the next step will either jump to location 1000h or continue with the 
program. 


RELATIVE ADDRESSING 


The previous jump instructions used immediate extended address- 
ing (the target address is part of the instruction). Another form of jump 
instruction uses relative addressing. This means that the new location 
to jump to is given in terms of an offset (plus or minus so many bytes) 
from the present location. Instead of supplying the absolute location 
within the instruction, as done previously, the new destination is given 
relative to the current position. The Jump Relative instruction has two 
major advantages. First, it only uses two bytes of memory (one for the 
op code; another for the relative offset) instead of three. The second 
advantage of using relative jumps is that they make the machine 
language program relocatable or position independent. This means 
that a program written to run at location 1000-1020, for example, could 
be moved byte for byte into location 2000-2020 and still run correctly. 
We'll explain this by way of example. Suppose we had the following 
two lines: 


1000—- ED SF LD A>»R 
ig92-— CS 9010 JIPNZ 1900h 


Table 11-2. Op Codes for JUMP Group 
(Courtesy MOSTEK, Corp.) 


CONDITION 


CARRY CARRY EVE Be0 
JUMP ‘JP re s 
EX 
DD 
Ee 


DECREMENT B, 
JUMP IF NON RELATIVE | PCte 
ZERO ‘DJNZ’ 
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‘The first instruction reads the contents of the R register into A, 
setting the Z flag accordingly. If the contents of R was non-zero, then 
the second instruction causes the program to loop back to the first 
instruction. This program will continue looping around until the R 
register reaches 0 at which point the next instruction would be 
executed. If you’re wondering why the R register would change as this 
program is looping, remember that the R register is a special refresh 
counter that the Z80 increments automatically after each instruction. 
Technically, this program has a 50-50 chance of becoming an endless 
loop, but that's not important here. 

You should notice that some more numbers have been added to the 
machine language listing. This is necessary because we are now 
dealing with program jumps. This makes it important to know exactly 
where the program resides in memory. For this purpose, we will again 
follow the standard format used by assemblers and start each line by 
giving the-memory location for the first byte of code on that line. This 
will then be followed by the hex code for the instruction and then, 
finally, by the mnemonic form of the instruction itself. Of course, when 
writing programs, we start by writing down the mnemonic form first 
and then filling in the address and machine codes later. 

We can also define /abels that help keep track of what a program is 
doing. The last example might be written: 


LOOP LD A>2R 
JPNZ LOOP 


By using the label LOOP, we can easily tell what this section of 
machine code is supposed to do. To hand-assemble the preceding 
code, we only need to know a starting address for the program. If we 
assume that it starts at 1000h, then we would write: 


1900— ED SF LOOP LDA:R 
JPNZ LOOP 


The machine code for the first instruction is well defined. When we 
come to the second instruction, we start by looking up the op code for 
JPNZ which turns out to be C2. Next, we must determine the address 
which is to be placed in the next two bytes. For this we must look back 
to where the label LOOP: was defined (in this case, the previous 
instruction) and then use that address (i.e., 1000h). Thus, we have the 
complete instruction codes and can write the program as follows: 
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1@00—-— ED SF LOOP LD A:>R 
1002-— C200 10 JPNZ 120Dh 


_ Of course, all the computer cares about are the five bytes: E5, 5F, 
C2, 00 and 10. These tell the Z80 to do the operation’ which we have 
asked, namely sit in a loop until the R register equals zero. However, 
what if these same five bytes were moved to a different location in 
memory, say starting at address 2000? If we put these five bytes there 
and then could somehow disassemble them back into mnemonic 
form, this is what we might see: 


24@6@6—- ED SF LD A+R 
20¢62—-— C2 6610 JPNZ 1900h 


Well, this certainly looks the same! In fact, the instructions them- 
selves have not changed at all. But look at the second instruction. It still 
wants to jump to location 1000h. Now, however, we do not know what 
machine language program (if any!) resides at 1000h. In any case, the 
program no longer functions like it was supposed to. So this type of 
program is position dependent. 

Consider now a different approach to writing the same program, 
using the jump relative instruction: 


1000 ED SF LOOP LD A+R 
1002 20 FC : JRNZ LOOP: 


In hand-assemblying this program, the first line remains the same. 
The op code for the JRNZ instruction is 20h; so that’s pretty easy. 
Calculating the offset requires a little practice, however. We'll go 
through the formal procedure first and then look at a useful shortcut. 

When using relative addressing, the CPU reads the offset amount 
located in the second byte of the instruction. This value (it is a signed 
integer in the range —128 to +127) is then added to the program 
counter PC register to achieve the address for the next instruction to 
be executed. However, when the offset is being added to the PC, the 
PC register has already incremented to point at the address for the 
instruction following the JR instruction. Therefore, if it is a conditional 
jump relative and the condition is not met, the Program Counter is all 
prepared to fetch the next sequential instruction. 

However, if the condition is met (or if it was an unconditional jump), 
then the offset is added and the jump performed. If we were willing to 
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talk about jumps relative to “the start of the next instruction,” then we 
would have no difficulty calculating the offset needed for the JR 
instruction. Unfortunately, it is more common to think in terms of the 
jump instruction itself. The start of this instruction is two bytes less 
than the base used for calculating the jump location. Therefore, if we 
want to use the JR instruction as the base we will have to deduct two 
from the offset. This is the way they are shown in Table 11-1 and Table 
11-2. Remember, also, that whenever jumping backwards, the twos 
complement notation is used to specify the negative amount. When 
jumping more than 20 bytes forward or backward, you should probably 
calculate the offset using the formula: 


Offset = Destination instruction — Current JUMP instruction — 2 
or, in our example: 


1000 - 1902 —-2 = —4=FCh 


For short jumps, however, it is sometimes easier just to count bytes. 
In the example, this requires counting backwards in hex. If we start at 
the end of the JR instruction and call that byte FFh, then count back to 
the start of the previous instruction (the target of the jump), we would 
call the “20” byte FE, the “5F” byte FD and, finally, the “ED” byte FC. 
This value, FCh, is, therefore, the correct offset for the JR instruction. 

We'll now see what happens if we move this program to a new 
location. Taking these four bytes (note how the relative addressing 
also saves one byte) and placing them at location 2000h, we would 
have: 


2660 — ED SF LD ADR 
2660 — 26FC JIPNZ 2080 


This program will operate identically to the previous one. Note that 
relative addressing allows this program to be moved without changing 
the way it operates. This type of program is called position indepen- 
dent or relocatable. 


REGISTER INDIRECT JUMPS 


The Z80 also has the ability to jump unconditionally to the address 
pointed to by one of the registers HL, IX, or IY. Thus any instructions 
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which affect the contents of these registers can be used to set up the 
address for a jump. 


AUTOMATIC LOOPING 


The last instruction in the jump group is rather special. It is the 
Decrement B, Jump if Non Zero or DJNZ instruction. This is sort of like 
aFOR. . . NEXT loop in BASIC, with B as the control variable. To use 
this instruction, the B register is first loaded with the number of times 
that the loop is to be executed (up to 255). Then the desired code to be 
repeated is written. This is followed by the DJNZ instruction which 
points back to the beginning of the loop. The following example will 
load memory location 2000h with every possible value one at a time. 


1086 — 21 6020 LD HL + 222h 
1603 — 66 G¢ LB Bs® 

16065 — 70 LOOP LD (HL) +B 
1666 — 10FD DJNZ LOOP 


Let's analyze this program in detail. The first line sets up the HL 
register pair to point to location 2000h. Line two initializes the B 
register with a value of zero. As we shall see, this causes the loop to be 
executed 256 times. The third line begins the loop and stores the 
contents of register B into the memory location pointed to by HL. 
Therefore, memory location 2000h now holds a value of zero. 

The last line of the program does two things. First, it decrements B 
and then jumps back to LOOP: if B is nonzero. On the first pass 
through this instruction, the B register equals zero. Therefore, decre- 
menting B gives it a value of — 1 or FFh. If you prefer, you can also think 
of this as the number 255. In either case, B certainly is not zero so the 
jump back to LOOP: is executed. Now, the value FFh gets stored at 
location 2000h, B decrements to FEh, and the loop repeats again. This 
continues for 255 more times, decrementing the contents of 2000h by 
one for each pass through the loop. 

Finally, after storing the value of 01 at 2000h, register B is decre- 
mented, leaving a value of zero. At this point, the conditional jump is 
not satisfied and, therefore, the program continues with the next 
sequential instruction. 
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CALL AND RETURN GROUP 


In much the same way in which the GO SUB and RETURN state- 
ments are used in BASIC, machine language programmers can use 
the CALL and RETurn instructions. Table 11-3 and Table 11-4 show 
the various forms of these instructions. 


Table 11-3. CALL and RETURN Group 
(Courtesy MOSTEK, ahaa 


Symbolic Flags Op-Code No. of {No.of M|No.of T 


Mnemonic | Operation pe ee a 2a es Bytes {Cycles [States | Comments 
CAitan = |{SP-1)- PCy] @ [© | xX 11 001 101] CD | 3 5 7 
{SP-2) + PCy a 
PC - nn - nn 
CALLcc, nn|ifcondition |e |] Xe] XP efe felt cc 100 3 3 10 If cc is false 
cc is false - 2 ~ 
continue, ~-m. + 3 5 v7 If cc is true 
otherwise 
same as 
CALL an 
RET PC,~ (SP) fe |e} xfe}xfel]e]e iit aot got} co | 3 10 
PCy > (SP+1) 
RET ce {feondition |* |] *|] X}e;X}epe se iit cc 000 1 1 5 If cc is false 
cc is false 
continue, 1 3 "W If cc is true 
otherwise iti 
same as 000} NZ non zero 
RET 001) Z = zero 
010} NC noncarry 
RETI Return from f@ fe] X}° PX} e |e je [tt 101 101) ED 12 4 14 ay Cc carry 
interrupt 01 001 101} 40 100] PO parity odd 
RETNT Returnfrom [@ |e | X}e |X} e]e fe it 101 101} EO 4} 2 4 14 101] PE parity even 
non maskable ? 03 GOD 101} 45 110 | P sign positive 
interrupt 1M sign negative 
RST p (SP-t)-PCyle fe] xiepxxietetety t am 1 3 W 
(SP-2} = PCy 
PCy ~ 0 
PCL > p 


TRETN loads IFF2 ~ IFFy 


Flag Notation: © = flag not affected, 0 = flag resat, 1 = flag set, X = flag is unknown, 
} = flag is affected according to the result of the operation. 
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Table 1l-4. Op Codes for CALL and RETURN Group 
(Courtesy MOSTEK, Corp.) 


CONDITION 


3 
‘UN- NON PARITY | PARITY | SIGN SIGN REG 
COND. | CARRY! CARRY) EVEN opo NEG Pos B+0 


‘CALL’ 


RETURN REGISTER | (SP) 
‘RET’ : 


RETURN FROM 
INT ‘RETI’ 


RETURN FROM 
NON MASKABLE 
INT ’RETN’ 


NOTE-CERTAIN 
FLAGS HAVE MORE 
THAN ONE PURPOSE. 
REFER TO SECTION 
6.0 FOR DETAILS 


‘RST O° 


‘RST 8 


‘RST 16’ 


“RST 24° 


“RST 32° 


c 
A 
L 
L 
A 
Do 
Oo 
R 
E 
$s 
s 


“RST 40° 


‘RST 48° 


“RST 56° 


When writing a BASIC statement such as GO SUB 5000, it is quite 
obvious where the program should continue executing. The line 
number, 5000, is right there in the instruction. Have you ever won- 
dered, however, how the computer knows where to go when it reaches 
a RETURN statement, especially when one subroutine may have 
called another subroutine (i.e., they may be nested)? The answer is 
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quite simple. Whenever a GO SUB statement is executed, the com- 
puter keeps track of the line number it is currently on in an area of 
memory called the GO SUB Stack. Like all LIFO (Last in— First OUT) 
stacks the line number of the most recently executed GO SUB is 
always kept on the top. 

A GO SUB statement, therefore, requires that the current line 
number be PUSHED onto this stack. The statement number is also 
saved, since multiple statements can be placed on one line. Whenever 
a RETURN statement is encountered, the computer simply POPs the 
line and statement numbers off the GO SUB stack and continues 
executing with the next statement just after the GO.SUB. 

The machine language CALL instruction does much the same 
thing. It uses the machine stack to store the current address (two 
bytes) and then loads the Program Counter with the target address for 
the jump. You can also see this by looking at the symbolic description 
shown for the CALL nn instruction. As with other instructions that use 
the SP register, there is also the hidden operation of updating the 
contents of the SP register. You can add SP ¢SP-2 to the description of 
the CALL instruction if you want to be technically complete. Notice that 
there is also a conditional call instruction that can first test one of eight 
flag conditions. 

If you've followed everything so far, then it should be quite obvious 
how the RETurn instruction works. It simply POPs two bytes off the 
stack and stores them in the program counter. There is one big caution 
that needs to be mentioned here. Unlike the BASIC intepreter, which 
keeps a Separate stack for pending GO SUB instructions, the machine 
language CALL uses the Z80 machine stack. This stack may also be 

. used by other parts of a program temporarily to store data, addresses, 
status, etc. Therefore, it is imperative that the stack be in the proper 


state when the RE Turn instruction is executed. The RE Turn instruction: 


can also be made conditional.on the status of the flag bits. 

There are two more RETurn instructions that are used when the 
interrupt facilities of the Z80 are employed. These instructions. perform 
the same operation as a RETurn, but have special features that make 
them specifically applicable to interrupt routines. The RETI instruction 


is used to return from an IRQ service routine and the RETN instruction” 


should be used to end a Nonmaskable Interrupt routine. 
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RESTART GROUP 


The final group of instructions in this category is the Restart instruc- 
tions. These are eight, special-purpose instructions that CALL specific 
locations in page zero of memory. The advantages of these instruc- 
tions are that they only require one byte and they execute much faster 
than the normal CALL instruction. Routines that are used over and 
over are good candidates for use by the restart instructions. 


12 | 
Arithmetic and Logic 
Operations 


The Z80 instructions discussed so far have only dealt with one or 
two bytes of information. The load instructions, for example, simply 
move data from one location to another. The instructions we are now 
going to describe operate on two pieces of information in some 
defined manner to create a third. Thus we will have two source 
locations, as well as a destination register, to hold the result. To keep 
things simple, most of these instructions use the special-purpose A 
register or accumulator to hold one of the source operands and also to 
hold the result of the operation. All of these instructions affect the flag 
register according to the results of the operation. Refer to Table 12-1 
and Table 12-2 as we describe the arithmetic and logic operations of 
the Z80. 


Z80 INSTRUCTIONS 


ADD, ADC 


There are two types of Z80 instructions that perform addition. The 
first instruction, with the mnemonic ADD, simply sums the contents of 
the accumulator with a specified 8-bit value from another location. The 
result is placed in the accumulator and the flag register is set accord- 
ingly. The second operand can come from any of the other registers or 
from a memory location specified either directly or via the index 
registers. 

The second instruction, ADd with Carry (ADC), is identical to the 
ADD instruction except that the value of the Carry flag.(1 or 0) is added 
in, also. This makes it possible to do multiple byte, or multiple preci- 
sion addition. Suppose, for example, we wanted to add two 16-bit, 
unsigned integers. Assuming we could only work with eight bits at a 
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Table 12-1. 8-Bit ARITHMETIC and LOGICAL Group 
(Courtesy MOSTEK, Corp.) 


Symbolic Op-Code No.of [No.of MiNo.of T 
Mnemonic Operation Pe Rea re Bytes [Cycles [States | Comments 
ADD A,r A+Atr rtd 1 t 1 0 4 t Reg. 
ADD A,n A -Atn ht ; } : : ; 1 ami 2 7 000 B 
a 001 c 
010 D 
ADDA (HL) JA~ AHH | FP ty xt a] xP vio] 4 jo foa}100 1 2 7 01 E 
ADD A, (IX+d) [A~AHIXe) | PY ty xt de] xiv dod tito soi] po }3 fs 19 100 H 
10 {000}110 101 L 
-d- 1 A 
ADDA, (I¥+d) JA~AdI¥ed) | FP EP XE ET XP Vd opt iui tof ro ys) 19 
10 (000) 110} ° 
- d - 
ADC A,s A-Asecy Tt] a exirdxivdold:] fu sis any of¢,n, 
SUB s AwA-s tyepxPpiyxivigrade jo} HHL), (X40), 
SBCA,s A-A-s-CY TP] PEXt tixivirds oa] (Y+d) as shown for 
AND s A-Aas t]ayxetixfejolfo {60} ADD instruction. 
ORs A-Avs t] aE xPOTxpep toto io The indicated bits 
XORs A-Aws th rpxPotxfiedolo] fon replace the (000) in 
CPs Avs te ye xe tixiverde 7 the AOD set above. 
INCr rer} they XP PEXEV Oe joo + Goo 1 i 4 
INC (RU) (HU{HU+T] PEST XE ti xiv] 07° joo 110(t0g 1 3 W 
INC (IX+d) (Xd) = Heal xp ap xivio fe ji om io} oo 3 fe 23 
(IX+d)+1 00 110 (100 
ad 
INC (1Y+d) (Y¥+d) - tra] xt ap x]{vdo fe iitain to] ros 6 23 
: (1¥+a)+1 oo 110 (100) 
-d - 
OECs s-s-1 tht) xiaixivgade (io) s is any of r, (HL), 


(1X+d), (Yd) as 
shown for INC. 
(OEC same format 
land states as INC. 
Replace with 
flOijin OF Code. 


Notes: The V symbol in the P/V flag column indicates that the P/V flag contains the overflow of the result of the 
operation. Similarly the ? symbol indicates parity. V = 1 means overfiow, V = 0 means not overflow, P=1 
means parity of the result is even, P = Q means parity of the result is odd. 


Flag Notation: © = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown. 
t= flag is affected according to the result of the operation. 


time, we would start by adding the lower order bytes of the two 
numbers together. If this addition caused a carry-over into the next 
higher place, then we would have to add in the carry when we perform 
the addition on the higher order bytes. See Fig. 12—1. 

Writing a program to accomplish this procedure is relatively simple. 
First we decide where the operands will come from and where to store 
the 16-bit result. As a quick example, we'll write a program to add the 
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Table 12-2. Op Codes for 8-Bit ARITHMETIC and 
LOGIC Group 
(Courtesy MOSTEK, Corp.) 


SOURCE 


REGISTER ADDRESSING 


DECIMAL BINARY HEX 


1 
23004 01011001 11011100 
+ 3149 00001100 01001101 [40] 


01100110] fo00101001 


Fig. 12-1. Addition, with carry, of two 16-bit numbers. 
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Listing 12-1 
7000-11 DC 59 LD DE,59DCh 17,226,89 
7063-214D@C LDHL@C4Dh 33,77,12 
7006-78 LDA,E 123 
7007-85 ADDA,L 133 
7008- 4F LDC,A 79 
7069- 7A LDA, D 122 
7QGA- 8C ADC A, H 140 
76$B- 47 LDB,A 7] 
7G6C-C9 . RET 291 

Listing 12-2 — 


18 FOR a= 28672 TO 28684 

26 READd: POKEa,d 

30 NEXTa 

46° DATA 17,220,89,33,77,12,123,133,79,122,14,71,201 
98 :REM Nowlet’s do it! 
106 PRINT USR 28672 


contents of the DE register to the HL register, storing the results in BC. 
Listing 12-1 shows the result. 

The program starts by loading the two 16-bit operands into the DE 
and HL registers. To perform the addition of the lower bytes, we first 
load one operand into the accumulator. In this case, we pick the E 
register (i.e., the lower half of the DE pair). Next, we add the other low 
byte, in the L register, to the accumulator. This gives the lower order 
byte of the result which is then loaded into register C. At this point, if 
there was a carry from the first addition, the carry flag will be set. 
Otherwise, it will be reset. With the sample numbers chosen, it will be 
set because there is a carry. The accumulator is next loaded with one 
of the high bytes — the D register — in preparation for the second 
addition. 

The next instruction is an Add with Carry of the two high bytes (D, 
which already is in A, plus H). This allows any carry over from the 
previous addition also to get added in. After loading the high byte of 
the answer into register B, the program RETurns to BASIC. Note that 
when running this program from BASIC, we can easily print out the 
answer stored in the BC register by using the PRINT USR call. 

Listing 12-2 shows how to enter and RUN this program on the T/S 
2068. You should verify that the result printed is, indeed, the correct 
answer for the two numbers used. In fact, by changing the second/ 
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third and fourth/fifth bytes in the DATA statement, you can make this 
program add any two numbers. 


SUB, SBC 


Everything we have said about the addition instructions ADD and 
ADC, applies to the subtraction instructions SUB and SBC (SUBiract 
and SuBtract with Carry). The only difference, aside from the opposite 
operation being performed, is that the Carry flag is now used to 
represent a borrow condition. Listing 12-3 shows an example of 8-bit 
subtraction. This time, both the operands and the result are stored in 
memory locations. We can, therefore, POKE the minuend and sub- 
trahend into memory, call the subtraction routine with RANDOMIZE 
USR, and then PEEK at the remainder. Listing 12-4 shows how to do 
this from BASIC. 

Remember that this is a very simple routine. It does not check for 
any borrow condition and only handles 8-bit quantities. Of course, we 
can always write a multiple precision subtraction routine as we did for 
addition. 


Listing 12-3 
7060-3A 6B 76 LDA, (766Bh) 58,11,112 
7903-216C 76 LDHL, (76Ch) 33,12,112 
7006-96 SUB A,(HL) 150 
7667-320D7% LD (7@PDh),A 5¢,13,112 
79GA- C9 RET 261 
766B  : Contains Minuend 
7@6C =: Contains Subtrahend 
7608D =: Receives Remainder 
Listing 12-4 
18 FOR a=28672 TO 28682 
26 READ d: POKE a,d 
38 NEXTa 
46 DATA 58,11,112,33,12,112,15 
O58, 13,112,281 


6. : REM Store minuend 

76 POKE 28683,15¢ 

88 :REMand subtrahend 

98 POKE 28684,35 
198 RANDOMIZE USR 28672 
198 +: REM Now print theresult 
200 PRINT PEEK 28685 
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‘SIGNED ARITHMETIC 


So far, we have discussed addition and subtraction of whole, 
positive integers. Even our multiple precision addition routine is based 
on these assumptions. We'll now see what happens if we try to apply 
these routines to signed integers. 

Suppose we wish to add 100 + 75, using signed arithmetic. The 
problem would look something like this: 


(19,5) 01190100 
+ (7549) 01981011 


Cc 
(—81,.) @ 18101111 


We know the answer is not —81, so something must have gone 
wrong. The carry flag is not set, so the error is not due to a carry past 
the eighth bit. What has happened, however, is that the true answer, 
175, has exceeded the maximum amount that can be represented in 
twos complement form by eight bits (i.e., +127). This is known as an 
overflow condition. Likewise, whenever an operation results in a value 
less than — 128, we would have an underflow condition. In either case, 
the accumulator contains an erroneous value which can create all 
kinds of havoc, if it goes unnoticed. 

Fortunately, the Z80 knows about signed numbers, so it has a built- 
in overflow/underflow detector which appears to the programmer as 
the P/V bit in the flag register. Actually, the P/V (Parity/oVerflow) flag 
serves two purposes, depending upon whether the Z80 is performing 
a logical or arithmetic operation. For now, we are interested in its use 
as an overflow (or underflow) flag. 

Whenever an arithmetic operation, such as ADD or SUB is per- 
formed, the P/V flag is set according to the result of the operation. If the 
resulting value is between —128 and +127, and, therefore, is a valid 
signed integer, then the P/V flag will be cleared (i.e., set to 0); other- 
wise, it will be set. By testing this flag or using a conditional jump, the 
program can be diverted to handle the overflow condition properly. 


CP 


The Z80 has a special instruction for ComParing the binary values of 
the accumulator with any other location. What makes this instruction 
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special is that, unlike all of othe other arithmetic operations, no result 
gets stored. Actually, the CP instruction is just like the SUB instruction 
except that the accumulator is not changed. The flag register is 
affected, however, so this provides a way of comparing two values. 
This instruction is usually followed by a conditional jump such as JP Z 
(jump if zero, implying that the two values were equal) or JP NZ (jump if 
nonzero, implying that the two values were unequal). Other instruc- 
tions; such as JP C (carry, indicating that the accumulator was less 
than the other value) can also be used. Since the accumulator is not 
affected by the CP instruction, a series of comparisons can be made 
one after the other until a match is finally made. For example: 


LD A» DATAVALUE 
CP O1 

JP Zz ROUTINE 

CP @2 

JP Z ROUTINE? 

CP 03 

JP Z ROUTINES 


Jp NONE OF THE ABOVE 


INC, DEC 


The last two arithmetic functions supported by the Z80 involve 
incrementing (adding 1) and decrementing (subtracting 1) registers or 
memory locations. They do not require use of the accumulator, since 
only one operand is required. (The other operand is implied as 1 and 
the destination for the result is the same as the source.) The INC and 
DEC instructions can be applied to any register or any memory 
location via indirect (HL) or indexed (IX+d, IY +d) addressing. 


Logical Operations — AND, OR, XOR, NOT 


Aside from the arithmetic operations just described, the Z80 can 
also perform four basic logic functions on data values. Three of these 
require two operands — aANp, or, and xor — and will be described 
here. The fourth function, not or complement, only requires one byte 
and, in fact, can only operate on the accumulator. It will be described in 
a later group of instructions. 
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Performing the AND, or and eXclusive or instructions is very similar 
to the arithmetic functions. One operand is held in the accumulator, as 
is the final result. The other operand can come from any register or 
memory location. When the two operands are brought together inside 
the Z80's ALU, the appropriate logic function is then applied to each 
pair of bits. Each bit in the result is determined by the logic function and 
the values of the same bit position in each operand. The following 
examples should make this clear: 


19811919 19811910 . 10011819 
AND OR XOR 

91011119 91011119 61911119 

= 90811010 = 11911118 = 11988108 


When performing logical operations, the P/V flag is used to denote 
the parity of the result in the accumulator. Parity simply refers to 
number of 1 bits in the answer. If there are an even number, then the 


result is said to have even parity. An odd number means odd parity. . ' 


For example, the binary number 10111011 has six-1 bits and, therefore, 
has even parity. The P/V flag is set when the parity of the result is even; 
it is reset if the parity is odd. 

The parity of a number can serve many purposes. In ASCII repre- 
sentations, for example, which use a 7-bit code, the parity value can 
be placed in the eighth bit and sent along with the character. When 
transmitting data over long distances (e.g., through the telephone 
lines), the parity information can be used-to detect any errors in 
transmission. If one bit of the code is received incorrectly, then the 
parity of the data at the receiving end will not match that which was 
sent. This parity checking can alert the receiving device that it has 
incorrect data. Of course, if more than one bit gets changed during 
transmission, this scheme will not always work. 


16-BIT ARITHMETIC GROUP" 


Refer to Table 12-3 and Table 12-4 for information on the 16-bit 
arithmetic instructions. In general, the 16-bit operations are identical to 
their 8-bit counterparts. Watch out for the flag bits, however, as each 
instruction only affects certain flags. You might also like to note that the 
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Table 12-3. 16-Bit ARITHMETIC and LOGICAL Group 
(Courtesy MOSTEK, Corp.) 


Symbolic Flags Op-Code No. of [No.of MiNo.of T 


Mnemonic Operation [STZ] [PR] [PENT € [76 543 2107 Hex | Bytes | Cyctes | States | Comments 
ADO Ht,ss | HL ~ HLtss ete TX p xy X fe | a] 4 joo sst cor 1 3 YW $s Reg. 


oo = Be 
ADCHL ss |HL-Hessecy) tf yy x] xy xy viol t ii iri ex}2 ia 15 [ol DE 
01 ssi 010 100 HL 
11 SP 
spcHLss |HL-Hesscy | t] a yx Ext xi vgs] yp fir sorioy en f2 fa 18 
01 ss0 010 
ADDIX,pp JIX=iX+pp Je fedyx |x} x]efol] 4s tom to} onf2 fa 15 |op Reg. 
loo ppt oot ao) BC 
ot ODE 
10 IX 
11 SP 
ADDiY,n fiy-iven foe tedx|x[x]felopa tii io roy2 fa 15 |r Reg. 
loo ret oot oo) BC 
01 ODE 
1 06OY 
1 SP 
INC ss ss-sstl e}elx x fe fete loo so on 1 ot 6 
INC IX Ix-ixer fe fedxtelx]e]efe fit oi io] onf2 2 10 
: loo 100 011] | 23 
INGLY e-iver Je felxfe]x]efejefirinio rol2 j2 40 
loo 100 011] 23 : 
DECss ss ss-1 eletxfelx fe fede foosst ort 1 fl 6 
, DECIX IX = 1X1 ejelx]felx]fe]fele from to} poy2 2 10 
loo 301 011) 28 
DEC IY Wy =1Y-1 efelxfetxfefefe fii io} roy2 fz 10 
loo 101 o11] 28 


Notes: ss is any of the register pairs BC, DE, Hi, SP 
pp is any of the register pairs BC, DE, 1X, SP 
rr is any of the register pairs BC, DE, IY, SP. 
Flag Notation: = flag not affected, O = flag reset, 1 = flag set, X = flag is unknown. 
{ = flag is affected according to the result of the operation. 
16-bit addition routine in Fig. 12-2 can be greatly simplified using the 
16-bit ADD instruction. See how Listing 12-5 compares to the earlier 
routine. 


BIT OPERATIONS 


Some of the most powerful instructions available on the Z80 are the 
bit operations. These instructions allow the programmer to change or 
test the state of a single bit within any register or memory location. 
Table 12-5 and Table 12-6 show the various forms of the bit SET, 
RESet, and TEST instructions. 

The SET and RESet instructions affect only the indicated bit within 
the data location. The‘flag register is unchanged by these operations. 
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Table 12-4. Op Codes for 16-Bit ARITHMETIC and 
LOGICAL Group 
(Courtesy MOSTEK, Corp.) 


DESTINATION 


INCREMENT = ‘‘INC. 


: DECREMENT ‘DEC’ 


Listing 12-5 
7000- 3A $B 76 LDA, (7@Bh) 58,11,112 
7003- 21 {C 76 LDHL, (766Ch) 33,12,112 
7006- 19 ADD HL,DE 25 
7087-44 LD B,H 68 
70%8- 4D LDCGL 77 
7009- C9 RET 261 


The BIT instruction examines one bit of the desired location and then 
sets the Z flag according to that value. Note that if the bit is a zero, the 
Zero flag is set (=1). Therefore, the Z flag actually represents the 
complement of the bit tested. 

Bit operations serve many purposes in machine language pro- 
grams. They make it easy for a programmer to create external flag 
registers in memory. These registers can then be used to monitor and 
control various procedures within a program just as the flag register in 
the Z80 is used. Bit testing can also be used to tell if a number is odd or 
even, to check the status of an external device read through an I/O 
port, or to implement special data structures for efficient memory 
usage. 
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¢ REGISTER z 


OR MEMORY 


ROTATE LEFT 
CIRCULAR 


ROTATE RIGHT é REGISTER F | 
CIRCULAR OR MEMORY. 
eZ a REGISTER A 
ROTATE LEFT - OR MEMORY 


ROTATE RIGHT 


Z Cc 4 REGISTER a 
OR MEMORY 


Fig. 12-2. The ROTATE operations. 


ROTATE AND SHIFT GROUP 


Refer to Table 12—7 and Table 12-8 as we discuss the rotate and 
shift operations performed by the Z80. These operations generally 
involve a single eight-bit value plus the carry flag. A rotate operation 
causes each bit in the data location to move one position, either to the 
right or left. One bit gets rotated out of the operand and into the C flag. 
Sometimes this same bit is shifted into the opposite end of the 
operand. This is the case for the eight-bit Rotate Left Circular (RLC) 
and Rotate Right Circular (RRC) instructions. It is also possible to 
include the carry flag within the rotation, making for a nine-bit Rotate 
Left (RL) or Rotate Right (RR). Fig. 12-2 outlines the effect of these 
four instructions. Note that most of these instructions affect the entire 


Arithmetic and Logic Operations 


181 


Table 12-5. SET, RESet, and TEST Group 


Mnemonic 
BiTb,r 


BITb, (HL) 


BIT b, (IX+d)y 


BIT b, (1¥+d)y 


SET b, 6 


SET b, (HL) 


SET b, (IX+d) 


SET b, (1Y¥+d) 


RESb,s 


Notes: The notation sp indicates bit b (0 to 7) or focations. 


Symbolic 

Operation 
Z-% 
2-THOp 


Z ~ 1X4), 


th = 1 
{HL}p + 1 


(iX+d)p > 1 


UY+d)y = 1 


sp + 0 

s =r, (HU), 
(1X+d), 
(1¥+d) 


(Courtesy MOSTEK, Corp.) 


Flags 


x 


[27 je] PA 
x] TY) XIX 


XP pp Xp 


XP EL X] 1 


x 


x 


x 


x 


0 


° 


Op-Code 


[76 $43 210] 
TT O01 ON 


Or b or 
11 001 O11 
01 b 110 
11:011 107 
11-001 O11 
-d<- 
Or b 110 


11199 101 
11:007 O11 
-d- 
01 b 110 


11001 017 


i) bd + 


14 001 O11 
Is} b 110 
11-011 101 
11 001 O15 
-d- 
Yb 110 
11117 101 
11 001 011 
-de- 
fy b 110 


00) 


Flag Notation: © ~ flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
} = flag is affected according to the result of the operation. 


cB 
cB 


oo 
cB 


FD 
cB 


cB 
cB 
oo 
cB 


FO 
cB 


No. of |No.ofMINoof T 
| Hex | Bytes |Cyctes | States 


2 


2 


8 
12 


20 


20 


23 


23 


Comments 
r 

008 

001. 

010 

on 

100 

101 

WwW 

b Bi 
000 

aol 

016 

ou 

100 

101 

no 

WW 


2 
baal 


rPrrmM90 Oy 


Tested 


MOM eon ofF 


To form new Op: 
Code replace [fit 

of SET b, s with 
(10). Flags and time 
states for SET 
instruction 


flag register. Fig. 12-3 shows how the operations would apply to a 
sample data byte. 

Shift operations are very similar to rotates except that the link from 
the C flag into the data location is broken. Thus, the bit shifted out of 
the C flag is lost forever and the vacant bit position in the data byte is 
filled in with either a zero (logical shift) or a repeat of its last value 
(arithmetic shift). Shifting operations are mostly used to perform bi- 
nary multiplication and division. As we have shown in Chapter 2, 
shifting a binary number one bit position to the left is equivalent to 
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Table 12-6. Op Codes for SET, RESet, and TEST Group 
(Courtesy MOSTEK, Corp.) 


REG. 
REGISTER ADDRESSING INDEXED 


cB cB cB cB a cB cB 
47 40 42 43 45 46 
a 
cB cB cB cB cB cB cB cB 
4F 48 49 4A 4B 4D 4E g. 
a 
3 cB CB cB re cB . 8 ce 
51 52 53 55 
cB oe 
TEST SE Be 
‘BIT’ 
cB = cB cB cB re cB a £D 
67 61 62 63 65 
66 
FD 
cB = cB 
6F ac 6D cE d 
be 6E 
jeje) FO 
cB CB cB cB cB CB cB cB CB cB 
77 70 1 72 73 74 75 76 46 q, 


cB cB cB -_ cB 
7c 7D 7E d 
cB A cB cB cB 
87 81 82 83 
cB ce cB 
88 89 8A 
2 cB cB ca cB 
97 90 91 92 
cB cB 
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Table 12-6 — cont.Op Codes for SET, RESet, and 
TEST Group 


Db | FO 
ce | ca | ca | ce | ce | ce | ce | ce, | cB | cB 
cr | cs | co | ca | cB | cc jy cof ce | & | go 

DD | FD 
ca | ca | ce | ce | ce | cB | ca | cB | ce | ce 
7 | Do | O1 | D2 | 03 | Ds | oF | O6 | de | ge 

op | FD 
ce | ca | cB | ce | cB | cB | ce | ca | cB | cB 
DF | 08 | D9 | DA | DB | oc | oD | of | gd | gy 

po | &D 
ce | ca | cB | ce | ce | ce | ce cB | ce 
€7 | 6 | €1 | €2 | €3 | E4 | ES aot hee 

oD | FO 
ce | ca | ce | ce | ce | ca | ca | ca | cB } cB 
er | es | €9 | EA | EB | EC | eD | ce | d | gy 

Dp | FD 
ce | ca | ca | ca | cs | ce | ca | ca | cB | cB 
F7 FO FY F2 F3 Fa F5 F6 F6 F6 

; Do | FD 
7 ca | ca | cB ce | ca | ca | ca | ca | cB 
FF | Fs | F9 Fa | Fc | FO | Fe | de | de 


multiplying the number by two. Likewise, a right shift implements a 
division by two. 

Shifting a data byte always causes one bit to be shifted out into the. 
carry flag. At the other end of the byte, there is an empty bit position 
which must be filled. Normally, we will want to set this bit equal to zero 
so that multiplication and division operations give the correct results. 
The Shift Left Arithmetic (SLA) and Shift Right Logical (SRL) instruc- 
tions operate in this manner. 

The Shift Right Arithmetic (SRA) instruction is used to divide signed 
integers. Since the most significant bit represents the sign of such 
numbers, filling this position with a zero might change its sign. There- 
fore, the highest order bit is retained in its position as well as being 
duplicated into the next position. Fig. 12-4 and Fig. 12-5 outline the 
results of the various shift operations including the use of the SRA 
instruction to divide signed numbers. 


BCD Rotates 


The final two rotate instructions are used on numbers stored in BCD 
format. These instructions can rotate an entire digit (4 bits) to or from 
the accumulator. The other two digits involved in the rotate are stored 
in a memory location which is pointed to by the HL register. 
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Table 12-7. ROTATE and SHIFT Group 
(Courtesy MOSTEK, Corp.) 

Symbolic Op-Code No.of ms of Me of 

Mnemonic Operation fel fet eel fae [ek Merl Sk Comments 
RLCA 7——0 eye yX]O;X1e7 OF § [00 060 111} 07 4 Rotate left circular 
A accumulator 
RLA Oev}-—7—ao-* ele;x;orX}e] Oo} ¢ foo oro 111 fF 17 4 Rotate left 
A accumulator 
RRCA Cr—a-l ede Tx] ORX}e] oft foo oo: 111} OF 4 Rotate right circular 
A accumulator 
RRA —0 CY ete ix] oxy] off foo ott aii] iF 4 Rotate right 
A accumulator 
ALCr PPX POyXPe EOL S fit Oot or1y ce 8 Rotate left circular 
00 (000) + register r 
RLC{HL) tp eyX POPXPP Lor s fir 007 on] ce 15 Ir Ri 
00 (006) 110 000 8 
001 c 
RLC (1X+d) (CY} C—.) PP uTX POX] PPO} ¢ pit 017 101] oo 23 «[010 it) 
6 CHL), (IX+0),01¥ +0) 1 OOF O14) CB Qt E 
-do- 100 H 
00 [G00] 110 161 L 
WwW A 
RLE (1¥4d) |! Pa PX POX EP POTS fir tit 1004 FD fh 23 
+1 801 O11} CB 
ey News 
00 (00g) 110 
RLs Lty}-—f=—o}-! Heurxporxte fois: wig instruction format and 
s=r(AU,(IX+d), (1¥40) states are as shown for 
RLC's To form new 
RACs C thrpxgorxte fore 001) Op-Code replace (000) 
3 =r {H Lb (tx+d), (t¥+d) lof RLC’s with shown 
code 
ARs f——1) thalxdolxfetot:|] Ga 
$ =r (HL), UX+d) (IY 40} 
SLAs C¥}—f—t—o flr |xtolxfefols 
$ =r, FHL) (1X+d) (1¥ +0} 
SRAs gt) teifxfolxfPeloltr fay 
3 Sr (BU tX+d) (Ysa) 
SRLs 0 thi[xfoyxde fort) i 
$ =r (HU) (iX+d), 1¥ 4d) 
ALO ED FH tT EEX TOEXte TOF eft ios tory eo 18 {Rotate digit ieftand 
= Dt 101 111 | 6F right between.the 
lsceurnulator 
land tocation (HL). 
RRO ay eaam tLtbx fodx be | o Fe pr ror tor f eo 18 [Thecontent of the 
DY 100. ttt F 6? upper haif of the 
ccumulator is. 
lunattected 


Flag Notation: © = flag not affected, 0 = flag reset, 1. flag set, X= flag is unknown, 


Ss 


$ = flag is affected according to the resuit of the operation. 


MULTIPLICATION AND DIVISION 


As we saw in Chapter 2, binary multiplication involves nothing more 
than three simple steps: bit testing, bit shifting, and addition. Having 


ORIGINAL DATA 


AFTER 
RLC 


AFTER 
RRC 


AFTER 
RL 


AFTER 
RR 


SHIFT LEFT 
ARITHMETIC 


SHIFT RIGHT 
LOGICAL 


SHIFT RIGHT 
ARITHMETIC 
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o 1710011100 
% 

[‘] 001141001 

8 010014110 

] 001131000 

[| 010011 10 


| Fig. 12-3. Typical-results of the ROTATE operations. 


c REGISTER 0 
‘ OR MEMORY. 


REGISTER 
” OR MEMORY, 


cd “REGISTER 
OR MEMORY ~ 


Fig. 12-4. The SHIFT operations. 
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Table 12-8. Op Codes for ROTATE and SHIFT Group 
(Courtesy MOSTEK, Corp.) 


Source and Ortunanien 


8 
8] ag] ae] & 


TYPE 


Ax + 
DD 
8 
g 
& 
Oo 
ce 
3 
OE 
Py 
co 
a 
16 
Do 
co 
g, 
te 


g]s 
78) 8 


ROTATE 
SHIFT 


8 
$a) 88 


se] xe] ss 
4g | ae] eels 
88] 3g] aB]s6 

me] ae] a 


83 
me 


58 


8 


[Pr Ma] s~ Bo) oes capt Ot 


ace = 


Route Dat 
{LD Rognt 
Ace 


seen how the Z80 performs all of these operations, we are ready to 
write some basic multiplication (and division) routines. One thing that 
you learn very quickly when programming computers — whether in 
assembly language or BASIC — is that there are always many differ- 
ent ways to write a program. There is seldom ever one way which is, 
without question, the best. Most of the time, there are three “best” 
ways. 

One way is the shortest, using the least number of instructions and 
usually the smallest amount of bytes. This is always the preferred way 
when you have only a small amount of memory (RAM or ROM) in 
which to write the program. Another way is the fastest, using those 
instructions with fast execution times. Programmers often resort to 
some very esoteric tricks to achieve these goals. 

The final way to write programs is the one in which the program flow 
is easiest to follow. This method creates programs that are easy to 
explain and easy for the beginner to understand. The routines we are 
about to describe were not written for optimum speed or memory 
usage. But while they may not be the most efficient for a given task, 
they are still very useful, general purpose routines. These routines 
also provide an opportune time to add the final item to our assembly 
language listings: comments. Just like the REMark statement in 
BASIC, we can add comments to our program listings to make them 
easier to understand. We do this by adding a semicolon after the last 
operand in any instruction, or at the beginning of a line. Everything 
after the semicolon would be ignored by an assembler so we'll do the 
same. 


an 
oT] 


Arithmetic and Logic Operations 187 


DECIMAL 
VALUE 


af * 
wf ? 
oe : 
ef . 


SRA 
WITH A 
NEGATIVE o 111001 00 —28 
NUMBER 
AFTER 
SRA [>| 1111001 0 -14 


Fig. 12-5. Typical results of the SHIFT operations. 


8-Bit Unsigned Integer Multiply 


Listing 12-6 shows a routine which we have named UMULT. This 
program is written as a subroutine so that it can be called from other 
parts of a machine language program. UMULT takes the 8-bit 
unsigned value in register C and multiplies it by the 8-bit value in 
register B. Since an 8-bit by 8-bit multiply can yield a 16-bit product, we 
will store the result in the HL register pair. We can summarize the 
operation of this routine as follows: 
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Listing 12-6 


: UNSIGNED 8 X 8 MULTIPLY 


;MULTIPLIER IN C 
;MULTIPLICAND IN B 
;PODUCT IN HL 


UMULT LDE,8 
LD HL, 6200 
LOOP LDA,C 
RRCA 
LDC,A 
LDA,H 
JR NC,SHIFT 
ADD B 
SHIFT RRA 
LDH,A 
RRLA 
DECE 
JR NZ,LOOP 


;SIGNED 8 X 8 MULTIPLY 
SMULT 


SMI LD A,C 


SM2 CALL UMULT 
BIT g,D 
JR Z, DONE 
LDA,H 
CPL 
LDH,A 
LDA,L 
CPL 
LDL,A 
INC HL 

DONE RET 


;E used as a counter 
;Clear product register 
;Get multiplier 
;Rotate right 

;and re-save 


;If not 1, then skip add 
;Add multiplicand 

iC — H(7) H@) —C 
;Save new H 

;H() —> L(7) 


;Repeat for 8 bits 
Listing 12-7 


Clear product sign flag 
;Get multiplicand 

;Set flags 

;If positive, continue 
;Form 2’s complement 
;and re-save 

Keep track of sign 
;Get multiplier 

;Do the same for 
;multiplier 


;Do multiply 

;Check LSB of D 

;Exit if product is positive 
;Make 2’s compliment 
;of 16-bit product 


exit to caller 


1. Initialize register E to a value of eight. This register is used as a 
counter to make one pass through the loop for each bit in the 


multiplier. 
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2. Clear out the product register (i.e., set HL = 0000) so that we can 
keep a running total of the partial products. 

3. Start each pass of the loop by rotating out the next least signifi- 
cant bit of the multiplier. Since we want to get a new bit for each 
pass, we must re-save the rotated value back into the C register. 
We could also use a shift instead of rotate, but the latter pre- 
serves the contents of the multiplier. 

4. Load A with the high-order byte on the running total. 

5. Add the multiplicand to A only if the last bit rotated out from the 
multiplier was a 1. 

6. Rotate right the entire 16-bit total. 

7. Repeat the loop until done. 


To give each partial product its proper weight, this program uses a 
rotate right on the running total instead of a rotate left on each partial 
product. You should be able to see that they are equivalent. Thus, on 
the first pass through the loop we get the least significant partial 
product. This is added to the most significant byte of the total but then 
is shifted one bit lower. After eight passes through the loop, and eight 
rotate rights, this product takes on its correct importance in the least 
significant byte. 


8-Bit Signed Integer Multiply 


To extend our program to signed numbers, we merely have to test 
the sign of each factor before multiplying. First, we determine what the 
sign of the product will be — positive if the signs are the same; 
negative if they are different. Then we convert any negative numbers 
to their positive value. At this point we can CALL the unsigned multiply 
routine UMULT to perform the actual multiplication. When this routine 
returns, the product will be in HL. If the result is supposed to be 
positive, then we are all done. Otherwise, we must take the twos 
complement of the product to convert it to the proper format. 

Listing 12-7 shows the listing for the SMULT routine. Here the D 
register is used to hold the sign of the product. After performing the 
multiplication, the least significant bit of D is tested. If neither factor 
was negative, then D = 0, and, therefore, bit 0 of D is 0. Likewise, if 
both factors were negative, D would equal 2 and again bit 0 of D would 
be 0. If only one factor was negative, D would be 1 with bit 0 obviously 
set. In this case, we form the twos complement of the 16-bit result. 
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8-Bit Unsigned Integer Division Routine 


Writing a division routine requires a few more considerations. First of 
all, there is the problem of attempting to divide by zero. This condition 
must be trapped out before getting to the actual division routine. Then, 
there is also a question as to the precision necessary for the quotient. 
This may require that one or both of the operands be scaled to put the 
quotient into a given range. Finally, there is a choice of how to perform 
the actual subtraction process. At each step in the calculation, we 
must detect whether the divisor is larger than the current dividend. If it 
is, then a one is added to the left of the quotient and the divisor is 
subtracted from the dividend. Otherwise a zero is added to the quo- 
tient and no subtraction is performed. Instead of checking the two 
numbers first, it is often simpler to perform the subtraction first and 
then check for an underflow. If this happens, then the current quotient 
position is made a zero and the divisor is added back in. This is known 
as a restoring division because the partial dividend is restored to its 
original value if the underflow occurs. Listing 12-8 shows a typical 
restoring division routine for the Z80. 


Listing 12-8 
;UNSIGNED 16 DIVIDED BY 8 
;DIVIDEND (16 BITS) IN HL 
;DIVISOR (8 BITS) IN D 
;QUOTIENT (16 BITS) IN IX 
;REMAINDER (8 BITS) IN H 
DIV LDA,L ;Move dividend 
LDL,H 
LDE,@ ;Set for 16 bit SBC 
LD Hg ;Clear remainder 
LD B,16 ;Loop 16 times 
LD IX,6 ;Clear quotient 
LOOP ADDHL,HL __ ;Trick to shift left 
RLAA ;Get next bit 
JPNC,SHIFT — ;Skip if zero 
INCL 
SHIFT ADD 1X,1X ;Shift quotient left 
INC IX ;Set bit= 1 
ORAA ;Clear carry for SBC 


SBC HL,DE ;Do subtract 
“JP NC,NEXT sNo underflow, continue 
ADDHL,DE _ ;Otherwise restore 
DEC IX Set bit=2 
NEXT DJNZLOOP _ ;Do 16times 
RET ;Exit when done 


13 | 
Special Instructions and I/O 


Two of the most powerful features of the Z80 are its duplicate 
register sets and the block move/search instructions. This chapter will 
discuss how to use these advanced functions. We will also describe 
the INput and OUTput instructions which are used to transfer data 
through the I/O ports of the Z80. Then we'll finish the discussion of the 
Z80 instruction set by examining the general-purpose arithmetic and 
miscellaneous CPU control groups. 


EXCHANGE GROUP : EX and EXX 


As described in Chapter 4, the Z80 has two complete sets of 
general-purpose registers and a duplicate set of accumulator and flag 
registers. These primed registers can only be accessed by exchang- 
ing them with their nonprimed counterparts. Then data can be written 
to or read from these registers using the normal instructions. The A 
and F registers are always swapped together (AF ¢) AF’). The general- 
purpose registers (BC, DE, and HL). are also exchanged as a single 
group. See Table 13—1 and Table 13-2 for details of the Z80 Exchange 
Group. 

The Z80 also allows a limited number of exchanges to be performed 
between the special-purpose registers. The single byte op code EBh, 
for example, swaps the contents of the HL register with that in the DE 
register pair. Note that this is equivalent to the following code: 


LO TEMP,HL 
LD HL,DE 
LD DE,TEMP 


where TEMP is a 16-bit temporary storage register or memory loca- 
tion. Obviously the EXchange instruction saves memory, executes 
much faster, and does not require the use of a temporary storage 
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Table 13-1. EXCHANGE Group 
pear MOSTEK, Corp.) 


Symbolic 
Mnemonic 
€X OE, HL | DE+-HL 
EX AF, AF’ | AF ~-AF’ 


EXX CBC" 
DE-DE’ 
HL HL’ 


EX (SP), HLF H ~-(SP+1} 
L (SP) 
IXq—-{SP41) 
IX, -+4SP) 
Yq —(SP+1) 
YL {SP} 


Register bank and 
auxiliary register 
bank exchange 


EX {SP), IX 

EX (SP), lY 

Notes: @ P/V flag is 0 if the result of BC-1 = 0, otherwise P/V = 1 
@® Zflagis 1 if A= (HL), otherwise Z = 0. 


Flag Notation: © = flag not affected, 0 = flag reset, 3 = flag set, X = flag is unknown, 
= flag is affected according to the result of the operation. 


Table 18-2. Op Codes for EXCHANGE Group 
(Courtesy MOSTEK, Corp.) 


IMPLIED ADDRESSING 


location. Of course, only certain registers can be exchanged, so the 
preceding routine is useful as a general approach to exchanging data. 


BLOCK TRANSFER GROUP : LDI LDIR, LDD, LDDR 


Refer to Table 13-3 and Table 13—4 as we discuss the block transfer 
instructions. These four instructions can be used to copy a contiguous 
range of memory locations from one place to another. There are no 
restrictions on the source or destination addresses nor on the number 
of bytes transferred. In many cases, the source and destination 
addresses will overlap. Before using any of these instructions, the HL, 
DE, and BC registers must first be initialized. The HL pair is loaded 


Special Instructions and I/O 193 


Table 13-3. BLOCK TRANSFER Group 
(Courtesy MOSTEK, Corp.) 


Symbolic Flags Op-Code No. of [No.of MjNo.of T 
Mnemonic! Operation [S TZ] [HI] [P/V] W] C {76 543 210] Hex | Bytes | Cycles | States | Comments . 
10} 
Lor (DE(HL) Jo fe tx yoy xi ft] af e fr tor 101] co 2 4 16 - Load {HL) into 
DE ~ OE+1 10 100 O00} AOD (DE), increment the 
HL — HL+1 pointers and 
BC - BCT decrement the byte 
counter (BC) 
LOIR (DEI(HL) Je |e} xX] OPXY of] of © fit 101 1017 ED 2 § 21 WBC#O 
DE ~ DE+1 10 140 000} 80 2 4 16 IfBC=0 
HL ~ HL+1 
BC ~BC1 
Repeat untit 
BC=0 
D 
LoD (DEM~(HL) Je |e |x fol x] {fo fe fit tor io] ep 2 4 16 
DE - 0E-1 10 101 000) As 
HL > HUI 
BC - BC1 
LOOR {DE{HL) fe Fe xX }O]x] oO] 0} © fit 101 1017 ED 2 5 2 #BC#O 
DE ~ DE-1 NO 111 000) 88 2 4 16 (eBC =O 
HL ~ HUT . 
BC -8C-1 
Repeat until 
BC=0 
2) ® 
CPI A-(HL) ft] Py] XP sexe gpa de pr ser sory) eo 72 4 16 
HL -HL+1 0 100 O01) AI 
BC ~ BC 7 
: ® ® 
CPIR A- (HL) Pty x et yx eda |e fir tortor] en f2 5 21 if BC # 0 and A#{HL) 
HL + HL+1 0 110 001) 81 2 4 16 If BC =O or A= (HL) 
BC ~ BCT 
Repeat until 
A= (HU) or 
BC=0 


Notes: (P/V flag is 0 if the result of BC-1 = 0, otherwise P/V = 1 
® Ztlagis 1 if A = (HL), otherwise Z = 0. 


Flag Notation: © = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
fe. flag is affected according to the result of the operation. 


Table 13-4. Op Codes for BLOCK TRANSFER Group 
(Courtesy MOSTEK, Corp.) 


SOURCE 


Reg HL_ pomnts to source 
Reg DE pomnts to destination 
Reg 8C is byte counter 


“LOI — Load (DE — (HL) 
inc HL & DE, Dec BC 


“LDIR,’ — Load (DE)<— (HL) 
Inc Ht & DE, Dec BC, Repeat until BC = 0 


DESTINATION 


*LDD’ — Load (DE}«—(HL} 
Dec HL & DE, Dec BC 


“LDOR' - Load (DE)~#—-{HLt) 
Dec HL & DE, Dec BC, Repeat until BC = 0 
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with the starting address of the source range, DE is loaded with the 
beginning of the destination range, and the number of bytes to be 
transferred is placed in BC. This is easy to remember if you think of DE 
for DEstination and BC for Byte Counter. 

The LDI, or LoaD and Increment instruction, loads the data stored at 

“the memory location pointed to by HL into the memory location. 
pointed to by DE. Then the HL and DE registers are incremented and 
the BC register is decremented. After executing the LDI instruction, 
the program can determine if the entire range has been transferred 
(i.e., BC = 0) by testing the P/V flag. If this flag is 1, then there are still 
more bytes to transfer. The program can execute some more steps 
and then loop back to the LDI instruction to continue the block transfer. 
If the program does not need to perform any steps in between suc- 
cessive byte transfers, then the LDIR (LoaD, Increment, and Repeat) 
instructions can be used. This single instruction, all by itself, will 
transfer the entire range of bytes specified. As you can see from the 
symbolic representation, this instruction performs the LDI operation 
and, then, automatically repeats until BC = 0. 

The LDD (LoaD and Decrement) and LDDR (LoaD, Decrement, 
and Repeat) instructions are similar to LDI and LDIR except that the 
registers are decremented after each transfer. This allows the transfer 
to proceed from the highest memory location to the lowest. While most 
of the time it does not matter in which order the transfer is made, there 
are some cases where it can be very important. 

To simply transfer a block of memory from one range of addresses 
to another, nonoverlapping range, either LDI or LDD can be used. With 
LDI, the lowest memory address of the source range would go into HL, 
and the lowest address of the destination is put into DE. BC, of course, 
gets the total number of bytes in the block being transferred. 

With LDD, the highest address of both ranges would be used; BC 
would stay the same. After executing either of these block moves, the 
results would be identical: a copy of the source range would be 
transferred into the destination range. See Fig. 13-1. 

When the source and destination ranges overlap, however, things 
change considerably. For example, suppose we want to move a range 

' of bytes up or down by one address. Except for one byte, every 

address in the destination range is also in the source range. Therefore, 
when we read data from a source location, it is important to make sure 
that the original data is still there. We would not want to retrieve data 
from this location that had already been transferred previously from 
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ADDRESS ADDRESS 


1000 
1001 
1002 
1003 
1004 


1000 
1001 
1002 
1003 
1004 


2000, 
2001 
2002 
2003 


2000 
2001 
2002 
- 2003 


USING LDD USING LDI 
HL = 1003h HL = 1000h 
DE =2003h DE = 2000h 
BC=4 BC=4 
Fig. 13-1. Transferring a block of memory with nonoverlapping 
ranges. 


another source location. Under these circumstances, the entire desti- 
nation range would end up being filled with just one value — that of the 
initial source byte. Of course, this can also be a useful operation. 

Fig. 13-2 shows the outcome of moving a block of memory up one 
byte using the LDDR instruction. The arrows indicate the memory 
transfers; they are numbered to show the order in which they take 
place. Note that we must start at the high end of the range and then 
work our way down for this operation to work properly. Had we started 
at the bottom of the range and used the LDIR instruction, we would 
have the results shown in Fig. 13-3. 


BLOCK SEARCH GROUP: CPI, CPIR, CPD, CPDR 


Another set of instructions which acts on an entire range of locations 
is the Block Search Group. (See Table 13-5 and Table 13-6). These 
can be used to look through a range of bytes for the occurrence of a 
particular hex value. Like the block transfer group, the search can be 
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1000 
1001 
1002 
1003 
1004 


1000 
1001 
1002 
1003 
1004 


BEFORE 


USING LDD 


HL=1003h 
DE = 1004h 
BC=4 


Fig. 13-2. Moving a block of memory up one byte using LDD. 


1000 
1001 
1002 
1003 


1000 
1001 
1002 
1003 
1004 


BEFORE 


USING LDI 


HL = 1000h 
DE=1001h 
BC=4 


Fig. 13-3. Moving a block of memory up one byte using LDI. 


done manually or automatically and from either direction. To use these 
instructions, we first load HL with the starting address of the search 
and BC with the number of bytes to search. The Accumulator is loaded 
with the value that we are looking for. 

Upon execution of the CP! (ComPare and Increment) instruction, 
the contents of the memory location pointed to by HL will be compared 
with the value in the accumulator. That is, the memory value is sub- 
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Table 13-5. BLOCK SEARCH Group 
(Courtesy MOSTEK, Corp.) 


Symbolic 


Mnemonic Operation 


ceD A-(HU 
HL ~HL-++ 


BC ~BC-1 


If BC #0 and A# (HU) 
If BC = Oor A= {HL} 


CPOR 


A-(HL) 
HL~HU1 
BC ~BC-1 
Repeat until 
A=(HL) or 
BC=0 


Notes: (0) P/V flag is 0 if the result of BC-1 = 0, otherwise P/V =1 
@® Z flagis 1 if A= (HL), otherwise Z = 0. 


Flag Notation: © = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
= flag is affected according to the result of the operation. 


Table 13-6. Op Codes for BLOCK SEARCH Group 
(Courtesy MOSTEK, Corp.) 


SEARCH 
LOCATION 


‘CPI’ 
inc HL, Dec BC 
EO ‘CPIR’, Inc HL, Dec BC 
Bt repeat until BC = 0 or find match 
Ea ‘CPD’ Dec HL & BC 
ED “CPOR’ Dec HL & BC 
Bg Repeat until BC = 0 or find match 


HL paints to location in memory 
to be compared with accumulator 
contents 

BC is byte counter 


tracted from the accumulator, and the flag register is set according to 
the results of this operation. The Z flag is used as always to specify 
whether the two bytes were equal. If they were, then the Z flag is set. 
Following the compare, the HL register is incremented and BC is 
decremented. The P/V flag serves a special purpose after a CPI 
instruction. It is set to 0 if the remaining value in the BC register is zero. 
Otherwise, P/V = 1. 
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The CPIR (ComPare, Increment, and Repeat) instruction automati- 
cally repeats until either a match is found or the byte count reaches 
zero. The flag register is affected in the same way as the CPI instruc- 
tion. CPD (ComPare and Decrement) and CPDR (ComPare, Decre- 
ment, and Repeat) are the descending versions of the preceding 
group. All of the block move and search instructions are extremely 
useful when dealing with character strings. They allow us to move 
entire strings around or to search them for certain characters. 


INPUT AND OUTPUT GROUP: IN, OUT 


The Z80 has a fairly extensive set of instructions to communicate 
with external devices through the use of ports. As discussed in Chap- 
ter 5, an I/O port is just another way to get data into or out of the CPU. 
To access an I/O port, we use the IN and OUT instructions and supply 
a port address. Most of the Z80 1/O instructions use the C register to 
hold the 8-bit port address. During the I/O operation, the contents of 
this register are placed on the lower 8-bits of the address bus. The 
contents of the B register are placed on the upper 8-bits, so, in effect, 
we have register indirect addressing using the 16-bit BC pair. 

This is how we can access over 65,000 different ports, if needed. 
Most Z80 computer systems find 256 I/O ports more than sufficient so 
the Z80 literature usually refers to only an 8-bit port address. Inthe T/S 
2068, however, we have already seen that the joystick port uses a 9-bit 
address, and the entire 15 address bits are used for reading the 
keyboard. Let's take a closer look at the INput and OUTput instruc- 
tions, as shown in Table 13—7 and Table 13-8. 

The first instructions are the IN A,(n) and the corresponding OUT 
(n),A. These are the only two I/O instructions that do not use register 
indirect addressing. Instead, they use immediate addressing. That is, 
the byte following the op code is used to specify the port. This is used 
to form the lower half of the address bus with the accumulator going to 
the upper eight bits. This form of addressing can only be used to do I/O 
with the A register. Let's see how these instructions might be used to 
access one of the ports in the T/S 2068. 

If you recall, the joystick inputs on the T/S 2068 are connected to the 
1/O port in the PSG. Therefore, to access these inputs, we must first 
address register 14 of the PSG. This is done by putting out 14 on the 
PSG address port (F5h). We then read the joystick signals on the PSG 
data port (F6h). But, to select which of the two joysticks we want, we 
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Table 13-7. INPUT and OUTPUT Group 
(Courtesy MOSTEK, Corp.) 


Symbolic Flay Dp-Code No.of jNo.ofM [No.of T 
Mnemonic | Operation 1S [Z] [Hi [P/ViN | C176 543 210) Hex | 8; Cycles [States | Comments 
INA, {n) A + {n) ele;xte |x} e7e |e fii ail om) oB [2 30° In nto Ag ™ Az 
- a + Acc to Ag ™ Ags, 
IN r, (C) r+ (C) tiadx ta] edo © [13 101 30%} ED [2 3 12 Cto Ag~ Az 
it r= 110 only 01 r 009) Bto Ag ~ Ats 
the flags will 
be affected 
(0) 
IN (HL) + (C) XPERUX EX] X] X] 17 x]11 tor wy eo 42 4 16 Cta Ag™ Az 
B+8-1 10 100 O10} AZ Bto Ag ~ Aqs 
HL ~HL+1 
INIR (HL) = (C) XETX |XX} XP PP] X pit t01 10m EO 72 5 21 Cto Ag ~ Az 
B- 8-1 10 110 O10) 82 tit 8 #0) BtoAg~ Ais 
HL + HL+1 2 4 16 
Repeat until If 8 = 0) 
B=0 
a 
IND (HL) = (C) XP t]XExPXE XE EP X [tt tor 101) €o {2 4 16 Cto Ag ™ Az 
B-B-1 10 101 010) AA Bro Ag ~ Atg 
HL +HL-1 
INDR (HL) + (C) XETTX EX YX] XP ty xX 421 101 wot) ED 72 5 21 Cto Ag ~ Az 
Hy 8-8-1 10 111 010) BA (lf 8 #0) BtoAg™ Aqs 
: HL = HL-1 2 4 16 
: Repeat until If 8 = 0) 
3 B=0 
OUT in), A | in)~A eferx pe yx} e]e fe jit aro on} o3 42 3 W nto Ag ~ Az 
i Acc to Ag ~ Aqs 
4 : OUT (C),r | iC) =r ele TX ye yxpe]e fe jit wot tor Eo 42 3 12 Cto Ag~ Az 
i é Ol r oY BtoAg™ Ais 
® 
i ¢ OuTI B-B-3 X]q UX |xyX] x] vy xX pst 101 1osp eo ]2 4 16 Cto Ag™ Az 
/ (C) = (HL) 10 100-011} =A3 BtoAg™ Ais 
H HL - Hit] 
; OTIR 8-8-1 XPUTX PX IX] XPT] X ft ror wow ep 42 § 2 Cto Ag™ Az 
(C) ~ (HL) 16:110 O11] 83 it B 40) BtoAg~ Ays 
HL ~ HL+1 2 4 16 
Repeat until If B=0) 
B=0 
Oo} 
OuTo (C} ~ {HL) XPRTX EXYX] XP 1] xX Jrt 101 101] ED 42 4 16 Cto Ag ~ Az 
B-B-t 10 101 012] AB Bto Ag ~ Aqs 
Hi = HE-4 : 
OTDR (C) = (HL) X}PUyX PX YX] X71 [x [11 109 101) ED 42 5 2 Cto Ag~ Az 
8-8-1 40111013] 88 If 8 #0) Bto Ag ™ Aqs 
HL = Ht-2 2 4 16 
Repeat until 1€ B= 0) 
B=0 


Notes: (®) If the result of B- 1 is zero the Z flag is set, otherwise it is reset. 


Flag Notation: © = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
} = flag is affected according to the result of the operation. 


also have to set the ninth address bit (A8) accordingly. The following 
routine accomplishes this task with immediate mode 1/O instructions: 


LDA, 14 Select 1/O register 
OUT (FSh) +A jon PSG 
LD A» PLAYER ;Set to either 2 or 1 


IN A+ (FEh) ;Read joystick 
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Table 13-8. Op Codes for INPUT and OUTPUT Group 


PORT ADDRESS 


az-4emR00y Ama 


INPUT ‘IN® 
INPUT 
DESTINATION 
“INI — INPUT & 
Inc HL, Dec & 


“INIR’— INP, inc HL, 
Dec 8, REPEAT IF B40 


“IND'—INPUT & 
Dec HL, Dec B 


“*INDR’—INPUT, Dac HL, 
‘Dec B, REPEAT IF B40 


SOURCE 


“OUTH — OUTPUT 
(nc HL, Dec b 


‘OTIR’ — OUTPUT, Inc HL, 
Dec B, REPEAT IF B40 


"QUTD’ ~ OUTPUT 
Dec HL& B 


*OTDR’ — OUTPUT, Dec HL 
& B, REPEAT IF B¥O 


PORT 
DESTINATION 
ADDRESS 


BLOCK INPUT 
COMMANDS 


BLOCK 
OUTPUT 
COMMANDS 
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‘BLOCK I/O: INI, INIR, IND, INDR, 
OUTI, OTIR, OUTD, OTDR 


The Z80 is also capable of transferring a block of data through an I/O 
port. In this case, the HL register is loaded with the starting address of 
a memory range; the B register is used for a byte count. Since only the 
8-bit B register is used, block I/O operations are limited to 256 bytes at | 
one time. With the INI, IND, OUTI, and OUTD instructions, the Z flag is 
used to indicate when the B register has been decremented to zero (Z 
= 0 means that there are more bytes to transfer). Other than that, 
these instructions are used just like the block transfer commands. 


GENERAL-PURPOSE ARITHMETIC GROUP: DAA, 
CPL, NEG, CCE SCF 


There are five general-purpose arithmetic instructions which oper- 
ate on the accumulator or the carry flag. These are shown in Table 
13-9 and Table 13-10. The DAA (Decimal Adjust Accumulator) 
instruction is useful when BCD arithmetic is performed. After perform- 
ing addition or subtraction of BCD data, the result may not be in the 
correct form. Consider: 


26 9 8186 611 6 
3 5 
35 @ 611 @ 1 1 


@ 161 1 1 1 not valid BCD format 
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Table 13-9. GENERAL-PURPOSE ARITHMETIC Group 
(Courtesy MOSTEK, Corp.) 


Symbolic Flags Op-Code No. of [No.of M | No.of T 
‘Mnemonic | Operation Lap Pf ee Bytes | Cycles | States” | Comments 
OAA Converts acc, | ¢ | 4 | X ° 00 100 131 2? 1 1 4 Decimal adjust 
content into accumulator 
packed BCD 
following add 
or subtract 
with packed 
BCO operands 
cet A-k @}ey XP 1} XP e yd] © [00 101 t11f 2F 1 1 4 Complement 
accumulator 
’ (One's complement) 
NEG A-Atr TET] xi et xiv dtd g fir or io eo | 2 2 8 Negate acc, {two's 
101 000 100) 44 complement) 
CCF cy-tY eye; xP xy xte fod ¢ joo ws ity 3F 1 1 4 Complement carry 
. flag 
SCF cY-1 ele; X}O] XP e PO] t foo wo wi] 37 1 1 4 Set carry flag 


Table 13-10. Op Codes for GENERAL- PURPOSE 
ARITHMETIC Group 
(Courtesy MOSTEK, Corp.) 


Decimal Adjust Acc, ‘DAA’ 
Complement Acc, ‘CPL’ | 2 | 
Negate Acc, ‘NEG’ 

{2's comptement) 


Complement Carry Flag, ‘CCF’ 
Set Carry Flag, ‘SCF’ 


After executing the DAA instruction, however, we would have the 
correct result: 


61 @ 112 686 


The CPL (ComPLiment accumulator) instruction causes every bit in 
the accumulator to be changed. Thus: 
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Accum.| 1 0 0 1 14 1 0 1 


becomes after CPL 


Accum.| 0 1 1 000 14 #0 


The NEG (NEGate accumulator) instruction replaces the value in 
the accumulator with its twos complement notation. Therefore: 


Accum.; 1 0 0 1 1 1 #0 4 


becomes after NEG 


{ 


Accum! 0 1140001 14 


The last two instructions in this group operate only on the Carry flag. 
CCF (Complement Carry Flag) inverts the value of the flag while SCF 
(Set Carry Flag) forces the flag to 1. Although there is no direct 
instruction to reset the carry flag, this is easily accomplished through 
other single byte instructions such as AND A,A. 


MISCELLANEOUS CPU CONTROL: NOP HALT. DI, 
EL, IMO, IM1, IM2 


Table 13-11 and Table 13-12 describe the instructions that control 
the operation of the Z80 and set the interrupt response mode. The first 
instruction is the NOP (No OPeration) which does just that — nothing. 
There are many reasons for having such an instruction. Probably the 
most common use for the NOP is to replace unnecessary or revised 
instructions in a previously written program. It is also useful for writing 
time-sensitive routines, since it will add a slight delay (one machine 
cycle) to the execution of a program. 

The HALT instruction causes the CPU to stop executing its program 
until an interrupt is received. This is used to synchronize a program to 
external hardware. The T/S 1000, for example, uses such a scheme to 
let the Z80 perform the task of generating the video display. 
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Table 13-11. MISCELLANEOUS CUP CONTROL Group 
(Courtesy MOSTEK, Corp.) 


Symbolic 


HALT CPU halted 

or 

el" 

MO Set interrupt 
mode 0 

M1 Set interrupt 
mode 1 

IM2 Set interrupt 


mode 2 


No operation 


Fi No. of | No.of M | No.of T 


“| Comments 


Notes: FF indicates the interrupt enable flip-flop 
CY indicates the carry flip-flop. 


Fiag Notation: © = flag not affected, 0 = flag reset, 1 = flag set, X = flag is unknown, 
t = flag is affected according to the result of the operation. 


*\nterrupts are not sampled at the end of E} or Di 


Table 13-12. Op Codes for MISCELLANEOUS CUP 


DISABLE INT ‘(Dt 
ENABLE INT ‘(E1) 
SET INT MODE 0 

“IMO 
SET INT MODE 1 

“IM1" 
SET INT MODE 2 

"M2 


CONTROL Group 
(Courtesy MOSTEK, Corp.) 


8080A MODE 


CALL TO LOCATION 0038,, 


INDIRECT CALL USING REGISTER 
1 AND 8 BITS FROM INTERRUPTING 
DEVICE AS A POINTER. 


The two instructions — DI (Disable Interrupt) and El (Enable Inter- 
rupt) — control the software maskable interrupt facilities of the Z80. 
After executing the El instruction, the internal IFF (Interrupt Flip Flop) 
flag is set, allowing an interrupt signal to be recognized. This flag will 
stay set until either the DI instruction is executed or an interrupt is 
received. An interrupt service routine should end with the El instruc- 
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tion, if further interrupts are to be recognized. Since the Z80 does not 
check for an interrupt signal immediately following the El instruction, if 
the next instruction is a RETI (Return from Interrupt), the routine will 
return properly without any danger of another interrupt routine starting 
before the first one ended. Of course, nested interrupts with varying 
priorities can be implemented if desired. 

The IMO (Interrupt Mode 0), IM1, and IM2 instructions are used to 
select how the Z80 will respond to interrupts. While a complete discus- 
sion of interrupts is beyond the scope of this book, we will give a brief 
description of the three modes available. The default condition is IMO 
which allows the Z80 to handle interrupt requests like the 8080 CPU. 
Since the Z80 was designed to be an enhanced replacement for this 
early microprocessor, this mode is necessary for complete software 
compatibility. In the 8080 mode, the device generating the interrupt 
must place an instruction op code onto the data bus during the 
interrupt acknowledge time. This allows the device to “hardware pro- 
gram” the CPU to execute any instruction. This will usually be a restart 
instruction to a special interrupt handling routine somewhere in RAM. 

In Mode 1, which the T/S 2068 uses, an interrupt causes a restart to 
location 38h. Thus, the interrupt handler would be loaded into that 
address. If the routine is of any great length, then a JuMP instruction to 
another area of memory may be used. Since the T/S 2068 uses 
interrupts to read the keyboard, there is a routine at location 38h to 
perform this task. 

Mode 2 interrupts are used when the Z80 is attached to any of its 
peripheral chips. These devices support a comprehensive, vectored 
interrupt scheme which allows the interrupt to generate an indirect call 
to any location in memory. To accomplish this, the Z80 uses the | 
register as the upper 8 bits of an address and another 8-bit vector from 
the interrupting peripheral. This address points to an entry in a table of 
interrupt service routine addresses. Thus, the CPU reads the contents 
of this address, plus the next one, to find out the actual location of the 
service routine. The Z80 then performs a CALL to that address. , 

The Z80 also supports another interrupt structure called the NMI 
(Nonmaskable Interrupt). A different signal is used to generate an 
NMI, which always causes a restart to location 66h. There is no way to 
disable these interrupts. 

With the completion of this chapter, we have described the entire 
280 instruction set. In the next section, we will show how machine 
language can be used from BASIC on the T/S 2068. 


SECTION B 
MACHINE LANGUAGE ON THE 
, T/S 2068 


14 a 
Using Machine Language 
From BASIC 


Now that we have covered the Z80 instruction set, we can begin to 
get serious about using machine language programs. Aside from 
writing the program itself on paper, we now have to consider how it will 
interact with the rest of the T/S 2068 hardware and software. First, we 
have to determine where in memory the program will reside. Then we 
have to physically place the program there. At the same time, we must 
ensure that the program will not interfere with the normal operation of 
the computer and vice versa. Consideration must be given to all of the 
computer’s resources and how they are used. Memory locations, 
register usage, bank switching status, etc., must all be examined. 
Finally, don’t overlook such hidden traps as the presence of external 
devices or the computer's interrupt generation (60 times = Pet second to 
read the keyboard). 


CREATING A MACHINE LANGUAGE PROGRAM 


Obviously the first thing we have to do is to create the machine 
language program that we wish to execute. For example, suppose we 
want to fill the screen with a constant dot pattern. We know from 
Chapter 8 that this involves filling the memory locations in D FILE 1 
with a constant byte. This could be written in BASIC as follows: 


19 FOR i = 16384 TO 22528 : POKE i+ 51: NEXT i 


When you run this program, the screen will slowly fill up with the binary 
pattern represented by the data in the POKE statement. We chose the 
value 51 because in binary it becomes 00110011. Thus the screen will 
take on a pattern of vertical lines 2 pixels wide with 2 pixels in- 
between. You might also want to try other values such as 85, 17, or 7. 
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With a little playing around, you should be able to verify the structure 
shown in Fig. 8—5. This should be especially evident by the order in 
which the screen gets filled. 

No matter what value you POKE in, the preceding program takes 
about 48 seconds to completely fill the screen. This is a classic 
candidate for replacement by a machine language routine. Such a 
program might look like Listing 14—1. This is the block move routine 
that is set up to replicate the first byte into an entire memory range. 
This first byte is defined by the second line of ihe routine which shows 
this value in binary form. 


CHOOSING THE RIGHT LOCATION 


The next thing we must consider is where to put the machine code. 
While BASIC will let us POKE the program almost anywhere in RAM, 
we must not do so indiscriminately. As we saw in Fig. 5-2, much of the 
computer's memory is dedicated to a particular use. We certainly 
would not want to POKE the program into the middle of the machine 
stack or on top of our BASIC program. If we examine this figure 
carefully, we will find that there are five distinct sections of memory. 
The stationary RAM, which is used by the system software, runs from 
location 16384 (D_FILE_1) to location 26709 (PROG — 1). This 
includes the display and attribute file, machine stack, bank switching 
code, etc. These data structures are always present (with minor 
changes when D FILE 2 is used), and therefore represent a fixed 
overhead on the available RAM. The area of memory between PROG 
_and E LINE —1 represents the storage of our BASIC program and its 
variables. This, of course, will constantly be changing, and it can grow 
until all of the available RAM is used up. Directly above the variable 
storage, we find another series of system data structures. These 
include the edit buffer and the temporary work space for the BASIC 


Listing 14-1 
LD HL, 16384 ;Start of D_FILE_1 
LD (HL),60118811 ;Pattern byte to replicate 
LD DE,16385 ;First byte to transfer 
LD BC,6143 ;Length of D FILE_1 
LDIR : ;Go to it! 


RET ;Return to BASIC 
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interpreter. This section of memory, from E LINE to STKEND, also 
moves around as the computer is used. With the exception of a small 
area at the very top of memory, the remaining RAM from STKEND to 
RAMTOP is unused. After RAMTOP, we have the data for the user- 
defined graphics characters. This continues up to the very last byte of 
RAM. 

In looking for a place to put a machine language program, we can 
see that almost everything below STKEND is being used. There are a 
few tricky places to put machine code, such as in the area reserved for 
the printer buffer (if you are not using a printer, then these 256 bytes 
can be used for anything you desire). In general, however, we will 
want to place machine language programs above STKEND, into the 
unused area. 

Since this free RAM gets eaten up from the bottom end as memory 
usage grows, it makes sense to place the routines as high as possible. 
This means that they should go just below the User Defined Graphics 
area. This is, in fact, where most machine language routines will be 
placed; we will show how to protect this area from BASIC. 

In Chapter 12, we created some programs to run at location 28672 
(7000h). This location was chosen because it was a nice round hex 
address and we could be sure that it was in the unused area. We knew 
that it was above STKEND because we only had a short BASIC 
program and a couple of variables being stored in memory. Since 
STKEND is initially set at location 26726, we knew that the program/ 
variable usage would have to reach almost 2000 bytes before mem- 
ory locations 28672 and above were needed. Thus, we were safe in 
putting our program there. 

There is still one more problem to deal with, however. No matter 
where in free memory that we place the routine, there is always the 
chance that the BASIC program or variables will expand to that point. 
Since BASIC has no idea that we have something meaningful at these 
addresses, it will blindly overwrite these locations with whatever data 
it needs to store. So the machine language program could get 
destroyed if we are not careful. 

Fortunately, there is a simple way to inform the BASIC interpreter 
that we do not want it to use memory locations above a certain 
address. This is the function of the system variable RAMTOP. It 
represents to BASIC the last byte of memory available to the inter- 
preter. Thus, if we can move RAMTOP down in memory, we will 
create a free area of RAM between RAMTOP and UDG. We can then 
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place machine language routines in this area where they will be safe 
from BASIC. While it is possible to change RAMTOP by POKEing ina 
new value, it is easier to use the CLEAR statement in BASIC. This 
statement automatically resets RAMTOP to the address specified by 
the command. Thus: 


10 CLEAR 65000 


will set RAMTOP to address 65000. Since RAMTOP is normally 
65367 on the T/S 2068, this would give us 367 bytes of free memory in 
which to place the routines. With RAMTOP set at 65000, the first byte 
available for machine code is at location 65001. 


ASSEMBLING THE PROGRAM 


Now that we know where the program is going, we will return to our 
example and hand-assemble it. We start by converting the starting 
address to hex (65001 = FDE8h). Then we look up the op code for 
each instruction and convert any binary or decimal operands to hex. 
This gives us the complete hex representation, or object code for the 
program. Finally, we convert each byte of hex code to its decimal 
equivalent (jot them down on the right side), and we’re ready to POKE 
the program into memory. After assembly, the program now looks like 
Listing 14-2. ; 

Listing 14-3 shows how we take the decimal values, placed in a 
DATA statement, and POKE them into the locations starting above 
the new RAMTOP setting. When this program is run, the screen fills 
up in about one-half of a second. That’s 100 times faster than the 
BASIC version! in fact, most of this half-second is still being used up 
by the interpreter executing the first five lines. Type: 


RUN 192 
Listing 14-2 
FDE8- 21 @@ 40 LD HL, 16384 33,6,64 
FDEB- 36 33 LD (HL),@6118811 54,51 
FDED- 11 01 46 LD DE,16385 17,1,64 
FDF@- 1 FF 17 LD BC,6143 1,255,23 
FDF3- ED BY LDIR 237,176 


FDF5- C9 RET 261 


Using Machine Language From BASIC 2il 


Listing 14—3 


18 CLEAR 65000 
20 FORa=659@1 TO 65914 
30 READ d: POKEa,d 
4g NEXTa : 
5@ DATA 33,0,64,54,51,17,1,64,1,255,23,237,176,261 
198 RANDOMIZE USR 65661 


to see how fast the machine language program really is. 

Once we have run the program, the machine language routine will 
be safely stored in memory. Typing NEW will wipe out any existing 
BASIC program, but the machine language routine will remain. Try it: 


NEW 
RANDOMIZE USR G5OO1 


CASSETTE STORAGE OF MACHINE LANGUAGE 
ROUTINES 


Once we have a working machine language program, we may want 
to save it on cassette. Before we typed in NEW, the BASIC program 
that POKE’d it in was still in memory. This program contains the 
machine language routine as a series of numbers in the DATA state- 
ment. Obviously, it can be saved on cassette, reloaded back in, and 
then RUN to execute the routine. When the machine code is less than 
50 — 100 bytes, this method works fine. 

With longer routines, we begin to suffer a few problems. First, it 
should be noted that the DATA statement representation of the code 
requires several times as many bytes as the actual code. This is 
_ because each hex byte will require eight to ten bytes when placed in 

the DATA statement (1-3 bytes for the decimal digits, 6 bytes for the 
“number” code and its 5-byte value, and another byte for the comma 
between each data element). 

Thus a moderately long machine language program will require a 
very long BASIC program to POKE it in. This means that the BASIC 
program will also take quite a long time to load in from cassette. The 
loop which does the POKEing can also take a considerable amount of 
time when the program is RUN. To make matters even worse, after 
the routine has been POKE’d in, there are actually two copies of the 
same program taking up memory space. The original data (which 
takes up the most room) is no longer needed so it is wasting space. 
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This can be solved by DELETEing the program lines which do the 
POKEing along with the associated DATA statements. 

A much better approach to saving and loading machine language 
programs is to use the special forms of the SAVE and LOAD com- 
mands. If you type: 


SAVE “screen” CODE 65901 +14 


then the machine language routine will be saved on tape (even though 
it’s still hidden from BASIC). The SAVE . . . CODE command allows 
you to “dump” any portion of the T/S 2068’s memory, in binary form, to 
the cassette. 

To retrieve the program, we would type: 


LOAD “screen” 65001514 


This can be done in the command mode or from any point within a 
BASIC program. Since we usually want to use the machine code in 
conjunction with a BASIC program, it makes sense to have them both 
loaded in at the same time. This can be accomplished by having one 
of the first lines of the BASIC program do the LOAD... CODE 
operation. Under these circumstances, you would also want to have 
the BASIC program begin executing as soon as it is loaded. With our 
example, we could do this by writing a new BASIC program: 


10 LOAD “screen” 65001414 
20 RANDOMIZE USR GSGG1i 


Then we would save it onto cassette with: 


SAVE “demo” LINE 19 


and as soon a the report code appears, type: 


SAVE “screen” 65001:14 


This will place both parts of the program next to each other. If you now 
rewind the tape and type: 


LOAD “demo” 


the screen demo program will automatically start executing. 


15 | 
Using the Built-in ROM 
Routines 


This chapter is for the adventurers out there who really like to dig into 
their computers. One of the most exciting things you can do with a 
computer is to poke around (or should that be PEEK around?) with its 
ROM program attempting to discover some useful subroutines. Many 
times, you will find some interesting POKE’s or USR calls that allow 
you to do things not possible from BASIC. Or you might discover one of 
the interpreter’s routines that can be accessed directly — even from 
BASIC — to perform a given function. This information can make your 
BASIC programs run much faster and your machine language pro- 
grams easier to write. 


PRECIOUS POKES 


Probably the best place to go looking for POKES is in the Table of 
System Variables found in Appendix D of the Timex Sinclair 2068 User 
Manual. By now, some of these cryptic descriptions should make a 
little sense. Let's pick a few that have some really useful function. 
Memory location 23609 is called PIP because it holds a value that 
determines the sound that the T/S 2068 makes when a key is pressed. 
When the computer is first turned on, this location is initialized with a 
value of one. This causes the very short click that you normally hear 
when pressing a key. If you change this value by entering: 


POKE 23605 1128 


you will find that the key “click” has now become a key “beep.” Actually, 
itis the length of this beep that is stored in location 23609. Therefore, 
when the computer initializes this byte to 1, it really makes only one 
cycle of the tone which sounds like a click. 
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Another interesting location to POKE at is address 23562. This is 
called REPPER, and it controls the speed of the auto-repeat feature on 
the keyboard. The value at this location represents the delay — in 
Yeoths of a second — between successive repeats when a key is held 
down. Initially it is 5 but you can change this to any number from 1 to 
225. Try typing: 


POKE 23562 +1 


and then hold down the space bar. One thing to watch out for: this 
function is somewhat tied to the previous one. If the PIP value is very 
large, then it takes a considerable amount of time for each beep to be 
produced. The computer will not accept another keystroke until it has 
finished sounding the previous one. Therefore, it is possible that the 
PIP value will override the REPPER rate setting. By the way, location 
23561 holds a value called REPDEL which sets the time that a key 
must be held down before it begins to repeat. You cannot hurt the 
computer in any way by changing the values of these system vari- 
ables. The worst that can happen is that the computer will hang up, 
and you will have to turn it off and back on again to regain control. So 
be adventurous! 


USING USR 


With most computers, the real hacker would next begin to explore 
various ROM routines. Finding out where they are, what they do, and 
what else they affect can be fun, but it also takes a lot of time. In the 
case of the T/S 2068, there is another point to consider. At the time this 
book is being written, there is a strong possibility that the ROMs in the 
computer will undergo some changes. Therefore, any routines that we 
might document here could well end up being obsolete in the near 
future. This is one of the negative aspects of using ROM routines in 
your programs. Fortunately, however, Timex has incorporated a spe- 
cial section in the ROM which makes everything much easier. 


THE FUNCTION DISPATCHER 


Built-in to the T/S 2068 Operating System ROM is a mechanism for 
handling all of the basic functions of the computer. During initialization, 
this ROM installs a special utility program into RAM at location 6200h 
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(or FA50h if D FILE 2 is being used). This utility, called the Function 
Dispatcher, forms a consistent interface between application or sys- 
tem software and the rudimentary operations needed to control the 
T/S 2068 hardware. ; 

Table 15-1 lists all of the functions currently available to the Function 
Dispatcher.* Note that each function.is identified by a service code 
number. To use the Function Dispatcher, we must first initialize the. 
machine stack and then PUSH a two-byte value representing the 
service code. Any other registers used by the particular function are 
then set up. Finally, a call is made to the Dispatcher which then 
performs the desired task. It does this by CALLing certain other 
routines stored in ROM. 


As an example, let's see how we can plot a point on the screen using 
the PLOTBC routine. This routine performs the equivalent of the 
BASIC statement PLOT C,B. There are also four variations of this 
command, depending upon the value stored in the system variable 
PFLAG (23697). Bit 0 of this variable is called XOR-CH; bit 2 is called 
INV-CH. Table 15-2 outlines the significance of these bits to the 
PLOTBC function. Normally this routine will cause a pixel to be set. 

Listing 15—1 shows a machine language routine that uses the Func- 
tion Dispatcher and PLOTBC to draw a vertical line on the screen. This 
involves plotting 174 separate points from within a loop. Since the B. 
register holds the vertical coordinate for the PLOTBC operation, we . 
use the DJNZ instruction to create the loop. We, therefore, start by 
initializing the B register to 175 and loading the C register with the 
desired X-coordinate (in this case 127). We can load both registers 
simultaneously using the LD BC instruction. 

Next, we begin our loop by saving the BC register on the stack. This 
is because the contents of this register will get changed after calling 
the Function Dispatcher. We then need to PUSH two sets of 2-byte 
zeros to set up the stack for the Dispatcher. We PUSH the service 
code onto the stack and we're ready to CALL the Function Dispatcher. 
After plotting the point indicated by register B and C, the routine 
returns to our POP BC instruction. This recovers the coordinates of the 
point just plotted. The DJNZ instruction lowers the Y-coordinate by one 
and then jumps back to plot the next point. After 174 points have been 


*As of this writing, it is known that some of these functions (such as CHNG VID) do not 
work. These problems may be corrected in future ROM revisions. 
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Table 15-1. T/S 2068 Functions 


Service 
Function Code 


W TAPE @ | Write a block to tape. 
R_TAPE 1 Read a block from tape. 
RD BIT 2  |Read a bit from tape. 
R EDGE 3 | Read an edge from tape. 
SLVM 4 General tape routine. 
LOAD 5 Load. 
MERGE 6 Merge. 
SAVE 7 Save. 
CHNG VID 8 Change video mode. 
W BORD 9 Write border color. 

19 Reserved. 

ll Reserved. 

12 | Reserved. 

13 Reserved. 
GET STATUS 14 
GET NUMBER 15 
BANK ENABLE 16 
GOTO BANK 17 
CALL BANK 18 
XFER BANK 19. 

20 Reserved. 

ai Reserved. 

22 Reserved. 

23 Reserved. 

24 Reserved. 
UPD K 25  |Scan keyboard. 
PARP 26 Sound routine. 
BEEP 27 BEEP command. 
K DUMP 28 COPY command. 
SENDTV 29 Send char. to screen. 
SETAT 38 Set print position. 
STTBYT 31 Fix attribute byte. 
R_ATTS 32 Temp. Atts.,. Perm. Atts. 
CLLHS 33 Clear lower half of screen. 


CLS 34 Clear entire screen. 
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Table 15-1 — cont. T/S 2068 Functions 


Service 
Code Action 


DUMPPR 35 Printer buffer sent to print. 
PRSCAN 36 Send scan to printer. 
DESLUG 37 Remove slugs from line buffer. 
K NEW 38 NEW command. 

INIT 39 Initialize. 

INCH 48 |Input character. 

SELECT Al Select current stream. 
INSERT 42 Insert bytes. 

RESET 43 Reset calculator stack. 
CLOSE 44 CLOSE command. 
CLCHAN 45 Close channel. 

OPEN 46 OPEN command. 
OPCHAN 47 Open channel. 

CAT 48 CAT command. 

DELETE 49 DELETE command. 
FORMAT 58 FORMAT command. 
MOVE sl MOVE command. 

FLASHA 52 Flash char. in A to screen. - 
FINDL 53 Find BASIC line. 

SUBLIN 54 Find sub-line. 

RECLEN 55 Record length. 

DELREC 56 Delete record. 

PUT LN 57 Send line to output. 
SYNTAX 58 Check syntax. 

EXECUTE 59 Execute line. 

FOR 68 FOR command. 

STOP 61 STOP command. 

NEXT 62 NEXT command. 

READ 63 READ command. 

DATA 64 DATA command. 

RESTBC 65 RESTORE be. 

RAND 66 RAND command. 

CON'T 67 CON'T command. 

JUMP 68 Jump to line. 

FIX Ul 69 Fix 1 byte # from calc. stack. 
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Table 15-1 — cont. T/S 2068 Functions 


Service 
Function Code 
FIX U 76 
CLEAR 71 
CLR BC 72 
GO SUB 73 
CHKUSR- 74 
RETURN 75 
PAUSE 76 
BREAK? 77 
DEF 78 
K LPR 79 
K PRIN 80 
P SEQ 81 
INPUT 82 
1SEQ 83 
NOTKB? 84 
COLOR 85 
HIFLSH 86 
SCRMBL 87 
PLOT 88 
PLOTBC 89 
GET XY 9B 
CIRCLE 91 
DRAW 92 
DRAW L 93 
EXPRN 94 
F SCRN 95 
F ATTR 96 
RND- 97 
F PI 98 
F INKY 99 
FIND N 100 
PSHSTR 191 
PAEDCB 182 
LET 193 
POPSTR 104 


Action 
Fix 2 byte # from calc. stack. 
CLEAR command. 
CLEAR bc. 
GOSUB command. 
Free space left. 
RETURN command. 
PAUSE command. 
Break key pressed? 
DEF command. 
LPRINT command. 
PRINT command. 
Print sequence. 
INPUT command. 
Input sequence. 
Test CURCHL=KB. 
Adjust attributes sysvars. 
Adjust attributes sysvars. 
Screen address calculator. 
PLOT command. 
Plot c, b. 
Get x and y. 
CIRCLE command. 
DRAW command. 
Draw line. 
Expression Evaluator. 
Run time action for SCREEN $. 
Run time action for ATTR. 
RND action. 
PI action. 
INKEY action. 
Find variable. 


‘Push string. 


Push A, E, D, C, B. 
LET command. 
Pop string. 
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Table 15-1 — cont. T/S 2068 Functions 


DIM command. 
Stack unsigned number. 


Read/Stack Integer. 
Get 16 bit #. 

Get 8 bit #. 

Output number on stack. 
Subtract. 

Add. 

Multiple (int). 
Multiply (FP). 
Divide. 

Truncate. 

Force Int FP. 
Integer Divide. 


SQR calculator. 
Exponentiation. 
Read character. 
Send character. 
Write character. 
Keyboard scan. 
Print cursor left. 
Print cursor right. 
Print newline. 
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Table 15-1 — cont. T/S 2068 Functions 


Action 
Print message. 
CLS command. 


Scrolling routine. 
Point action. 


nonce 


2 Set pixel. 
: 1 
1 g 
1 1 


Reset pixel. 

Invert pixel. 

Leave pixel as is. 
plotted, this routine returns to BASIC. By using the DJNZ instruction, 
we do not plot a point at the zero Y-coordinate location. 

Listing 15-2 shows the BASIC program to enter this routine into _ 
memory. After RUNning this BASIC program, type: 


RANDOMIZE USR G5001 


to RUN the routine. Note that it takes about one-half second to 
execute. 


Listing 15—1 
FDE8- 91 AF 7F LD BC,7FAF _ ;Start at (127,175) 1,127,175 
FDEB- C5 LOOP PUSH BC ;Save coordinates 197 
FDEC- 11 06 8 LD DE,G088 ;Set up 17,9,0 
FDEF- D5. PUSH DE ;Function 213 
FDF@- D5 PUSH DE ;Dispatcher 213 
FDF1- 11 27 £6 LD DE,89 ;Get Service Code 17,89,0 
FDF4- D5 PUSH DE ;and push it 213 
FDF5- CD @ 62 CALL 6240h ;GotoFunc. Disp.  285,9,98 
FDF8- C1 POP BC ;Restore coordinates 193 
FDF9- 10 EF DJNZ,LOOP  ;Do another point 16,239 


FDFB- C9 RET sExit when done 261 
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Listing 15-2 / 


18 CLEAR 65068 

26 =FORa=65961 TO 6592¢ 

38 READ d: POKEa,d a 

48 NEXTa , 

5g DATA1,127,175,197,17,8,B,2,13,213,17,89,G,213,25,0,98,193,16,239,261 


If you want to compare this to the equivalent BASIC program, type 
NEW and then: 


10 FOR i=175 TO1 STEP —1: PLOT 127+si: NEXT i 


This program takes 1.6 seconds to execute. In this case, the Function 
Dispatcher is adding some overhead to the machine language routine 
but it is still over three times faster. Of course, when you compare the 
machine language program of Listing 15—1 to the BASIC equivalent in 
terms of simplicity and readability, BASIC wins hands down. 

There you have the great compromise. Machine language programs 
will outrun higher level programs such as those written in BASIC. But 
the machine language programs will take considerably longer to write 
(and even longer to debug!). Machine language programs are also 
less easily modified. Having a knowledge of both BASIC and machine 
language will allow you to combine the best features of each according 
to your needs. The following paragraphs describe some of the other 
functions provided by the Function Dispatcher. 


W Tape (Service Code 9) 


This routine writes a block of data from memory to the cassette tape. 
Upon entry, the IX register should point to the starting address of the 
block and the DE register should specify the number of bytes to be 
written. Before beginning the block transfer, the contents of the A 
register will be written out; it should be a 0 for data or a FFh to indicate 
that the following bytes are header information. The header block 
contains information about a file such as its name and length. 

The data recorded on tape starts off with a leader signal. This is an 
800-Hz tone which lasts for about 5 seconds on a header block or 
about 2 seconds for a data block. Following the leader signal is one 
cycle of 2040-Hz tone and then the data. Each data byte is sent out 
serially, MSB first. A zero bit is indicated by one cycle of 2040 Hz, anda 
one bit is signaled by one cycle of 1020-Hz tone. After all the data bits 
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have been sent, a parity byte is added. This byte represents the 
Exclusive-or of all the previous data bytes. 


R TAPE (Service Code 1) 


This routine reads a block of data from the cassette. The number of 
bytes to be read is specified in the DE register. The IX register points to 
where the first byte will go in memory. The A register should also be set 
to a 0 or FFh to indicate what type of block is to be read. A running 
checksum is kept as the data is read in. This gets compared to the 
checksum byte recorded on the tape. This routine will return with the 
carry flag set if there were no errors. It returns with carry reset if the 
checksums did not match, if there were less than DE bytes read in, or if 
the block type was wrong. 


BREAK? (Service Code 77) 


This routine looks directly at the keyboard to determine if both the 
CAPS SHIFT and SPACE keys are being pressed (i.e., a BREAK). It 
returns with carry reset if this is true; otherwise, it returns with carry 
set. 


SCRMBL (Service Code 87) 


This is a screen address calculator. Since the pixel locations on the 
screen are stored in a scrambled form in memory, this routine is 
available to help unscramble it. Upon entry, the BC register should 
hold the PLOT-type coordinates. B should be holding Y and C should 
contain X. When this function returns, the HL register will be pointing at 
the byte in the display file where this pixel is stored. The A register will 
indicate the bit position within this byte. 


APPENDICES 


128 

296 

512 

1024 

2 048 

4 096 

8 192 

16 384 

32 768 

65 536 

131 072 

262 144 

524 288 

1 048 576 

2 097 152 

4 194 304 

8 388 608 

16 777 216 

33 554 432 
67 108 864 
134 217 728 
268 435 456 
536 870 912 

1 073 741 824 
2 147 483 648 
4 294 967 296 
8 589 934 592 
17 179 869 184 
34 359 738 368 
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APPENDIX A 
Powers of 2 


CoIYH HTkRoONHOM 


2—N 

1 

0.5 

0.25 

0.125 

0.062 5 

0.031 25 

0.015 625 

0.007 812 5 

0.003 90625 _ 

0.001 953 125 

0.000 976 562 5 

0.000 488 281 25 

0.000 244 140 625 

0.000 122 070 312 5 

0.000 061 035 156 25 

0.000 030 517 578 125 

0.000 015 258 789 062 5 

0.000 007 629 394 531 25 

0.000 003 814 697 265 625 

0.000 001 907 348 632 8125 

0.000 000 953 674 316 406 25 

0.000 000 476 837 158 203 125 

0.000 000 238 418 579 101 562 5 

0.000 000 119 209 289 550 781 25 

0.000 000 059 604 644 775 390 625 

0.000 000 029 802 322 387 695 3125 

0.000 000 014 901 161 193 847 656 25 

0.000 000 007 450 580 596 923 828 125 

0.000 000 003 725 290 298 461 914 062 5 
0.000 000 001 862 645 149 230 957 031 25 
0.000 000 000 931 322 574 615 478 515 625 
0.000 000 000 465 661 287 307 739 257 812 5 
0.000 000 000 232 830 643 653 869 628 906 25 
0.000 000 000 116 415 321 826 934 814 453 125 
0.000 000 000 058 207 660 913 467 407 226 562 5 
0.000 000 000 029 103 830 456 733 703 613 281 25 


APPENDIX B 
Hex to Decimal 
Conversion 
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Dec | Hex Dec 
194 El 225 
195 E2 226 
196 E3° 227 


84 132 A3 163 
85 133 A4 164 
86 134 AS 165 
87 135 A6 166 
88 136 A7 167 
89 137 A8 168 
8A 138 AS 169 
8B 139 AA 170 
8C 140 AB 171 
8D 14] AC 172 
8E 142 AD 173 
8F 143 AE 174 
90 144 AF 175 
91 145 BO 176 
92 146 Bl 177 
93 147 B2 178 
94 148 B3 179 
95 149 B4 180 
96 150 BS 181 
97 151 B6 182 
98 152 B7 183 
99 153 B8 184 
9A 154 B9 185 
9B 155 BA 186 
9C 156 BB 187 
9D 157 BC 188 
9E 158 BD 189 
BE 190 
BF 191 
Co 192 
193 


\ 


APPENDIX C 
ASCII Character Set 
(7-Bit Code) — 


OO | 101 | 110 j 111 

0 @ Pp Pp 
l A Q a q 
“2 B R b r 
3 Cc 5 c s 
4 D T d t 
5 E U e u 
6 F Vv f v 
7 G;Wlig w 
8 H xX h x 
9 I Y i y 
; J Z j Zz 
a ea al | 
L % I / 
M ] m } 

N A n ~ 

Fi ul | SI VS ? | Oo | — o | DEL 
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ene an 288 


i 
' 
\ 
i 
i 
\ 


Bit 


Index 


A 


Accumulator and flag registers, 80-81 
ADC, 170-174 

ADD, 170-174 

Add/Subtract (N) flag, 82 

Addition, 31-32 

Address bus, 77 

Addressing mode, 87-90 

Amplifier, 14 

Analog, 14-15 

AND, 176-177 

Arithmetic and logic operations, 170-190 
Arrays, 56 

Assembler, 146-147 

Assembling program, 210-211 
Attribute files, 136 

Audio basics, 115-117 

Automatic looping, 165 


B 


Bank 
selection, 91-93 
switching 
control, 94-97 
hardware/software, 93-97 
BASIC, 145-146 
Basic 
interpreter operates, 70-72 
parts, 16-18 
BCD rotates, 183-184 
Binary 
fractions, 35 
mathematics, 31-35 
number system, 25-47 
representation, 42-47 
system, 20 


addressing, 90 
operations, 176-180 
pattern, 15 
Bits of information, 18-20 
Block 
VO, 201 
search groups, 195-198 
transfer group, 192-195 


Boolean logic, 20-24 
Break? (Service Code 77), 222 
Buffer, 20 


Cc 


CALL, 159, 166-169 
and RETURN group, 166-168 
Carry (C) flag, 81 
Cassette storage of machine language 
routines, 211-212 
CCF, 201-203 
Central Processing Unit (CPU), 25 
Choosing the right location, 208-210 
Chords, 130 
Combining output channels, 127-130 
Computer, 13-24 
Conditional jump, 159 
Connecting to outside world, 103-112 
Converting 
decimal to hexadecimal, 41-42 
hexadecimal to decimal, 40-41 
to binary, 30 
to decimal, 28-29 
CP, 175-176 
CPD, 195-198 
CPDR, 195-198 
CPI, 195-198 
CPIR, 195-198 
CPL, 201-203 
CPU, 17 
operation, 84-85 
Creating machine language program, 
207-208 


D 


DAA (Decimal Adjust Accumulator), 
82, 201-203 
Data, 17 
bus, 77 
processing, 14 
structures, 64 
DEC, 176 
DI, 203-205 
Digital, 15 
Dispatcher, function, 214-221 
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Display 
files, 136 
mode(s), 136-138 
1, 138 
2, 139-140 
3, 140 
4, 140 
Dividers, 118 
Division, 39-40 
Dock 
bank, 93 
connector, 105-106 


E 


8-bit 
signed integer multiply, 189 
unsigned integer 
division routine, 190 
multiply, 187-189 
El, 203-205 
EX, 191-192 
Exchange group, 191-192 
Expansion 
banks, 93 
connector, peripheral, 106-112 
Exploring the T/S 2068 basic, 48-75 
EXROM bank, 93 
Extended addressing, 88, 155 
EXX, 191-192 


F 


Files, attribute, 136 

Flag register, 81-84 

Floating point, 58-62 

FOR ... NEXT loop variable, 66-68 
Function dispatcher, 214-221 


G 


General-purpose 
arithmetic group, 201-203 
registers, 81 

Ground, 19 


H 


Half carry (H) flag, 82 
HALT, 203-205 
Hand-coding, 146-147 
Harmonics, 117 
Hexadecimal number system, 40-42 
Home bank, 92 
memory map, 97 
Horizontal sync, 133 
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Hue, 135 


IMO, 203-205 
IM1, 203-205 
IM2, 203-205 
Immediate 
addressing, 87, 152-153 
extended addressing, 87 
Implied addressing, 89, 155 
IN, 198 
INC, 176 
Index 
addressing, 88-89, 154 
registers (IX.and IY), 79-80 
INI, 201 
INIR, 201 
Initialization, 48-50 
Input, 16-17 
and Output group, 198-200 
/Output facilities, 97-98 
Inside the PSG, 113-115 
INT (Interrupt Request), 86 
Integers, 54-58 
Interface, 16 
Interrupt Vector (I) and Memory Refresh 
(R), 80 
Introduction to machine language pro- 
gramming, 145-149 


J 


Joystick, 101-102 
connectors, 104-105 

JUMP, 159-165 

Jump, 88 
conditional, 159 
unconditional, 159 


K 
Keyboard, 98-100 


LDD, 192-195 

LDDR, 192-195 

LDI, 192-195 

LDIR, 192-195 

Line number, 72 

Linear span, 119 
Logarithmic, 119 

Logic elements, 24 
Logical operations, 176-177 
Looping, automatic, 165 
Luminance, 134 


M 


Machine language, 145-146 
programming, introduction to, 145-149 
Mechanical, 14 
Memory, 17 
map of T/S 2068, 91-102 
Microcomputer, 13 
Microprocessor, 13 
Miscellaneous CPU control, 203-205 
Mnemonic, 146 
Modified zero page addressing, 87-88 
Moving information: load instruction, 
150-158 
Multiplication, 35-39 
and division, 184-187 


N 


NEG, 201-203 

Negative numbers, 32-35 

NMI (Nonmaskable Interrupt), 86 
Noise generator, 122-123 
Nonprimed registers, 191 
Nontestable flag bits: H and N, 82-84 
Nonvolatile storage, 18 

NOP, 203-205 

Normalized, 59, 61 

NOT, 176-177 

Notations, scientific, 58-59 
Numbers, negative, 32-35 
Numeric arrays, 62-64 


° 


Octaves, 119 
OR, 176-177 
OTDR, 201 
OTIR, 201 
OUT, 198 
OUTD, 201 
OUTI, 201 
Output, 18 
Overflow, 175 


P 


Parity/Overflow (P/V) flag, 82 
PEEK command, 51-52 
Peripheral expansion connector, 106-112 
POKE command, 53-54 
Potential, 19 
Precious POKES, 213-214 
Primed counterparts, 191 
Program, 17 
assembling, 210-211 
counter (PC), 78-79 
creating machine language, 207-208 


Program—cont 
flow, 159-169 
storage, 72-75 
stored, 15 
Programming the PSG, 117-127 


R 


R tape (Service Code 1), 222 
RAM, 17 
Real numbers, 56 
Register 
addressing, 89, 150-152 
indirect 
addressing, 89-90, 153-154 
jumps, 164-165 
Registers, 77, 78-84 
Relative addressing, 88-90, 161-164 
RESET, 85 
Restart group, 169 
RETURN, 159, 166-168 
RGB video, 140-141 
ROM, 17-18 
Rotate 
and shift group, 180-183 
Left Circular (RLC), 180 
Right Circular (RRC), 180 


s 


Saturation, 135 
SBC, 174 
SCF, 201-203 
Scientific notation, 58-59 
SCRMBL (Service Code 87), 222 
Selecting tone and noise sources, 
123-124 
Setting 
amplitude, 125-127 
frequency, 118-122 
Shift Left Arithmetic (SLA), 183 
Shift Right Arithmetic (SRA), 183 
Shift Right Logical (SRL), 183 
Sign (S) flag, 82 
Signed arithmetic, 175-177 
16-bit 
arithmetic group, 177-178 
load group, 155-158 
Sound, 100-101 
Special 
functions, 85-86 
instructions and I/O, 191-205 
purpose registers, 78-80 
Stack pointer (SP), 79 
State tables, 20 
Storage, 
nonvolatile, 18 
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Storage—cont 
volatile, 18 
Stored program, 15 
architecture, 15-16 
String 
arrays, 65-66 
variables, 64-65 
Strings. 56 
SUB, 174 
Subtraction, 32 
Sync 
horizontal, 133 
vertical, 133 


Tables, 
state, 20 
truth, 20-24 
Testable flag bits: C, P/V, Z, S, 81-82 
Timbre, 117 
Token, 73 
Tremolo, 127-128 
Truth table, 20-24 
Tutorial on the T/S 2068 basic interpreter, 
50-51 


U 


Unconditional jump, 159 
Underflow, 175 
Understanding Z80 documentation, 
147-148 
Using 
built-in ROM routines, 213-222 
machine language from BASIC, 
207-212 
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Using—cont 
T/S 2068's programmable sound gen- 
erator, 113-130 
USR, 214 
USR command, 148-149 


Vv 


Variable storage, 54-70 
Varying variables, 68-70 
Vertical sync, 133 
Vibrato, 129 
Video 
basics, 131-135 
display, 18, 131-141 - 
RGB, 140-141 
Volatile storage, 18 


Ww 


W tape (Service Code @), 221-222 
WAIT, 86 

Waveshape, 117 

Whole numbers, 56 


x 
XOR, 176-177 
vA 
Z80 
- CPU, 77-90 


instruction set, 149 
instructions, 170-174 
Zero (Z) flag, 82 
Zero page addressing, modified, 87-88 


2 


ci EE 
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Timex’ Sinclair 2068 
Intermediate/Advanced Guide 


This second book in a series on the Timex Sinclair 2068 takes the 
reader beyond BASIC into the world of the computer's circuits, its 
microprocessor, and machine language. This book is written for 
the computer user with a basic understanding of programming 
who wants to learn what really makes his Timex tick. It covers 


@ Interfacing peripheral devices 

@ Machine language programs and subroutines 

@ Technical details of the Z80 microprocessor 

@ Information on using the Programmable Sound Generator 
@ Inner workings of the BASIC interpreter 


@ Memory mapping . 


The Timex Sinclair 2068 Intermediate/Advanced Guide teaches 
you the tricks of the programming trade—how to make everyday 
programs run faster, and how to make the 2068 do things you 
thought were impossible. 
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